Support Home Task Builder 2 AI Integrations

AI Integrations

  • Overview
  • Getting Access
  • Adding an API Key
  • AI Components
  • System Prompt

Overview


You can now integrate a chatbot powered by an external AI Large Language Model (LLM) into Gorilla as part of your study!

Read this quick guide to find out how to get access to the AI components, how to add the integration to your account, where to find information about the AI components, and how to add a system prompt governing all AI interactions in your task.

Watch our recent AI in Gorilla: More Interactive Studies, Richer Data webinar to see the AI features in action!

Getting Access


AI components are available by request as a premium add-on to any Gorilla subscription. To get access, email subscriptions@gorilla.sc.

If you don't have a subscription but would like to inquire about access to the AI components, email info@gorilla.sc.

Adding an API Key


To use the AI components in Gorilla, you will need an API key for a supported provider (currently either OpenAI or Gemini).

To integrate the API key in your Gorilla account and keep it secure:

  1. Go to My Account and click API Keys.
Screenshot of API Keys section of My Account
  1. Click Add API Key.

  2. Enter a name for your API Key into the API Key Name field, and enter your API key itself into the API Key Secret field.

Screenshot of Add Integration window with fields API Key Name and API Key Secret
  1. Press Next. Your API key is now saved to your account.

To use your API Key, enter the API Key Name inside angled brackets, e.g. <OpenAI>, into the API Key setting of each AI component in your tasks.

AI Components


There are four AI components:

  1. AI (ChatGPT) - Access a ChatGPT model from within your task. Use in combination with the AI Chat Box or Trigger - AI components below.
  2. AI (Gemini) - Access a Gemini model from within your task. Use in combination with the AI Chat Box or Trigger - AI components below.
  3. AI Chat Box - Integrate an AI-powered chatbot into your task for participants to interact with.
  4. Trigger - AI - Send instructions to an AI model. For example, the AI model can process a participant's response and return another response which can be saved to your data or displayed to the participant.

System Prompt


To give core instructions or background information that should be used by every AI component in your task, you can add a System Prompt. In your task, click Settings on the left-hand sidebar and select AI:

Screenshot of the System Prompt setting under Settings -> AI

The prompt you enter will be used by every AI in your task by default.

To disable the system prompt for a specific AI component, open Additional Settings on the component and toggle on the 'Ignore System Prompt' setting:

Screenshot of the settings for an AI (ChatGPT) component. Ignore System Prompt is toggled on