Skip to main content

Connecting Agent Spark to ChatGPT

Agent Spark is your human insights analyst. You can access Agent Spark directly through our platform or via your favorite LLM tool.

This article covers how to connect Agent Spark to ChatGPT. For more information on how to access Agent Spark in other ways, including via other LLM tools, see our article on how to access Agent Spark.

The connector for ChatGPT is compatible with both GWI Core and GWI USA depending on your subscription.

If you’re a Free user you can only use Agent Spark via our platform.

How to connect Agent Spark to ChatGPT

Getting started is simple - just follow these two quick steps:

  1. One-time setup by your IT or Development teams (Workspace admin)

  2. Configuration by the Workspace users/members (End user)

Below are the steps for both IT or Development teams and Workspace users/members to enable the connector in your workspace. Click on each to expand.

For IT or Development teams (Required first)

Reference: ChatGPT official documentation

  1. Create a new custom connector by navigating to Workspace Settings -> Apps & Connectors -> Create

You might be prompted to enable Developer Mode. This step is required to create and publish custom connectors.

Once you have created the connector, you can publish it within your organization’s workspace and then deactivate Developer Mode.

  1. Input the following information:

    1. Name: GWI Agent Spark

    2. URL: https://api.globalwebindex.com/v1/spark-api/openai/mcp

  2. Configure the authentication mechanism (OAuth 2.0) and click Create

  3. The connector will appear as a draft in Workspace Settings -> Apps & Connectors -> Drafts

  4. Test the connector in developer mode to ensure it works properly

  5. Once testing is complete, click Publish to make it available to all workspace members

For Workspace users/members (After IT setup is completed)

Web Version

  1. Open a new chat in ChatGPT web

  2. Click the ”+” button in the chat window

  3. Locate the GWI Agent Spark custom connector in the list and click Connect

Desktop Version

  1. Go to Settings -> Apps & Connectors

  2. Locate the GWI Agent Spark custom connector in the list and click Connect

You’ll be returned to ChatGPT and the GWI Agent Spark connector will now be available in your chat sessions. The connector will appear with a “custom” label next to its name.

Once connected, ChatGPT will use GWI Agent Spark whenever your insight indicates the use of GWI’s data.

Authentication Process (Both Web & Desktop)

  1. You’ll be redirected to the GWI sign-in page. Use your GWI credentials to sign in. If you don’t have a GWI login, click Sign up to create one

  2. Review the requested permissions and scopes, then click Allow to authorize the connection

Note: Please be aware that GWI provides the connectors only, and your use of your LLM to access Agent Spark is your own responsibility. You should check that you have the required rights and permissions to use your LLM with our connector. We require you not to allow your LLM to train on our data. We always recommend that you use paid or enterprise LLM accounts.

Troubleshooting

  • Connector not visible: Ask your IT or Development teams (Workspace Admin) to verify that the Agent Spark connector has been created and published.

  • Access denied during sign-in: Make sure you have an active GWI account. If you're unsure, check with your GWI contact to confirm.

  • Login Errors: Check in with your GWI contact to confirm that your GWI account has been set up correctly.

  • OAuth errors: Clear your browser cache or try connecting from an incognito/private browsing window.

Creating a custom GPT

If you have connected Agent Spark to ChatGPT and want a more tailored experience, you can create your own custom GPT powered by GWI data. This let's you define specific instructions, workflows, and use cases, so ChatGPT works exactly the way your team needs it to.

How to make your own custom GPT

  1. In ChatGPT, go to Explore GPTs

  2. Click Create (right corner)

  3. Make sure you're in the Configure tab

  4. Name your GPT (e.g. 'GWI Spark Focus Group – UK Gen Z Travel')

  5. Scroll down to Capabilities and enable Apps

  6. Click + Add and search for “GWI Spark” (or how you've named the Agent Spark connector)

  7. Do not add any Actions - a GPT uses either Apps or Actions, not both

Add instructions

In the Instructions field, tell the GPT when and how to use Spark.

See an example here

Spark usage: Use Spark to answer specific audience questions (who they are, what they do/like, attitudes, channels). If the user asks a big/strategic task (e.g., “make a media plan”), break it into sub-questions (audience profile, interests, media habits, motivations/barriers, key messages, channel fit etc), run Spark for each, then synthesise into recommendations. One analytical goal per Spark call. Prefer multiple narrow calls over one broad call.

Also add your use-case behaviour rules, how the GPT should structure responses, what extra context it should ask for, and what it should and shouldn’t do.

Test and publish

Test using the Preview panel on the right. When you’re happy, click Create to publish and share with your users.

Users will need the GWI Spark app connected to their own ChatGPT account before using a custom GPT. If the app isn’t connected, they’ll be prompted to connect it.

Alternative method: Creating a custom GPT using a token

You can also create a custom GPT using a GWI API token with Spark API access. If you already have a token, you can can find the step-by-step guide to creating a custom GPT using a token here. If you don't and would like to know more, please contact your Account Manager to discuss pricing.

Did this answer your question?