Manage integrations

Use Integrations to centrally manage knowledge bases, MCP servers, custom tools, and connectors, and use Model Credentials to manage your AI provider API keys. Store a resource once, then attach it to any agent in the same project.

Credentials

To save your credentials for a vendor:

In the navigation sidebar, select Model Credentials.
Select Create Credential.
Enter a descriptive Name for your credential.
From the Type dropdown, select ASR/STT, LLM, TTS, or MLLM.
Select the Vendor from the dropdown for which you want to add the credential.
Paste your provider's API Key and complete any other required fields, such as Region, which vary by vendor.
Select Create.

After you add a credential, you can select it from the Credentials dropdown when customizing your ASR, LLM, TTS, or MLLM configuration for any agent.

You can edit and delete credentials using the Action menu in the credential list.

Caution

Deleting a credential affects all agents that use it. Verify that no active agents depend on the credential before deleting, or update those agents to use a different credential first.

Credential security

Credentials stored in Model Credentials are:

Encrypted and securely stored in your Agora account
Only accessible to users with access to your Agora project
Never exposed in agent configurations or logs

Best practices

Use descriptive names to distinguish between development, staging, and production credentials.
Rotate API keys regularly according to your security policies.
Delete unused credentials to minimize security exposure.

Knowledge bases

A knowledge base provides your agent with additional context by supplying reference documents that the agent can draw on during conversations. Once created, knowledge bases can be attached to any agent from the Actions panel.

To create a knowledge base:

In the navigation sidebar, select Integrations.
At the top of the page, select Knowledge Bases.
Select Create Knowledge Base.
Enter a Knowledge Base Name and Description.
Upload one or more files by selecting Choose files.
Select Create.

Info

Supported file formats: PDF, DOCX. Maximum file size: 20 MB per file.

You can edit or delete knowledge bases using the Action menu in the knowledge base list.

MCP servers

MCP (Model Context Protocol) servers extend your agent's capabilities by enabling it to call tools provided by external services. Once added to Integrations, MCP servers can be attached to any agent from the Actions panel.

To add an MCP server:

In the navigation sidebar, select Integrations.
At the top of the page, select MCPs.
Select Create MCP Server.
Enter a descriptive Name for the MCP server.
Enter the Endpoint URL.
Set the server Protocol to SSE or HTTP.
Set the Timeout (ms). If the server does not respond within this duration, the agent stops waiting and continues executing.
Add HTTP Headers for authentication or additional configuration. Optional.
Add Query Parameters to append to the server URL. Optional.
Select Create.

You can edit, delete, or check the status of an MCP server using the Action menu in the MCP server list.

Custom tools

Custom tools let you define reusable HTTP tools for your agents.

To create a custom tool:

In the navigation sidebar, select Integrations.
At the top of the page, select Custom Tools.
Select Add Custom Tool.
Configure the request, function schema, and optional body template. See Custom tools for detailed setup guidance.
Save the tool.

After you create a custom tool, attach it to an agent from the agent editor Actions tab.

Connectors

Connectors provide built-in integrations that agents can use without requiring you to build your own HTTP or MCP layer.

Currently available:

HubSpot Connector: Connect HubSpot and attach it to agents that need contact and ticket workflows

After you connect, attach the connector to an agent from the agent editor Actions tab.