Connect integrations

Connect an external service and give an agent the tools to use it. Verify the connection with a small read-only task, such as listing GitHub repositories.

Before you start

Open the agent's project in Studio. In the integration catalog, find the service and open its setup page. That page identifies the authentication method, required credentials, and available tools.

You need access to the provider account that will authorize the project.

Enable the agent's tools

In Agents, review the selected agent's Integrations section. Enable the tools needed for the task and save its configuration.

Configure the authentication method

For an OAuth integration, ask the agent in Chat to use the service. When authorization is missing, Chat provides a connect link. Follow it and complete the provider's consent screen with the intended account.

For an API key, basic-auth, or client-credentials integration, open Environments. Add the variables named on the service's setup page to the environment the agent uses. Use the provider's documented variable names exactly.

If the catalog marks the integration as experimental, enable it with VERYFRONT_EXPERIMENTAL_INTEGRATIONS. Set the value to the integration's name, a comma-separated list of names, or all when the project intentionally enables every experimental integration.

Verify the connection

Return to Chat with that agent selected and request the read-only task. Check that the result comes from the intended provider account.

Open the response's run to verify the provider call and its result.

If authentication fails, check the account, required provider permissions, and credential variable names. After changing environment credentials, redeploy the affected environment so the runtime receives the new values. If no tool call appears, check the agent's enabled tools and clarify the request.

Next