--- title: Connectors in Elastic Agent Builder description: Learn about the Agent Builder connectors library, which configures access to external systems for agents. url: https://www.elastic.co/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/connectors products: - Elastic Cloud Serverless - Elastic Documentation - Elastic Observability - Elastic Security - Elasticsearch - Kibana applies_to: - Elastic Cloud Serverless: Preview - Elastic Stack: Preview since 9.4 --- # Connectors in Elastic Agent Builder The connectors library is hidden until you turn on the `agentBuilder:experimentalFeatures` [advanced setting](/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/get-started#enable-experimental-features-optional) in Kibana. The Elastic Agent Builder connectors library lets you configure action-based connectors that give agents access to external systems, such as messaging services, cloud functions, and third-party APIs. Elastic Agent Builder connectors leverage the underlying Kibana [Stack connectors](https://www.elastic.co/elastic/docs-builder/docs/4493/deploy-manage/manage-connectors) framework to securely store credentials and manage integrations. However, they are distinct from [Generative AI connectors](https://www.elastic.co/elastic/docs-builder/docs/4493/explore-analyze/ai-features/llm-guides/llm-connectors), which are used exclusively to configure external LLM providers and are deprecated. Elastic Agent Builder connectors are not affected by that deprecation. You manage connectors per Kibana space from **Manage components** → **Connectors**. Individual connector types in the catalog can be marked **Technical preview**. ## How agents use connectors Elastic Stack: Planned Elastic Cloud Serverless: Preview An agent can only run the connectors assigned to it. Agents look up connectors and load their sub-actions and parameter schemas at run time through the built-in `connector-discovery` [skill](https://www.elastic.co/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/skills), which **Enable Elastic capabilities** includes. To assign connectors, refer to [Assign connectors to an agent](#assign-connectors-to-an-agent). Elastic Stack: Preview from 9.4 to 9.5 Unlike standalone tools, connectors don't need to be assigned to agents: any agent can use any connector in the space. When an agent needs to interact with an external system, it automatically reads the schemas of the connectors available to it. It then uses a built-in system tool (`platform.core.execute_connector_sub_action`) to independently format API payloads and run specific sub-actions (for example, looking up a Slack channel ID or searching AlienVault OTX for threat intelligence) without any manual tool mapping. ## Add a connector To register a new connector: 1. In the sidebar, select **Manage components** → **Connectors** to open the **Connectors library**. 2. Select **Create connector**. 3. Select a connector type from the catalog. 4. Provide the required configuration. 5. Select **Save**. The configured connector appears in the library. Elastic Stack: Planned Elastic Cloud Serverless: Preview To let an agent use the connector, [assign it to the agent](#assign-connectors-to-an-agent). Elastic Stack: Preview from 9.4 to 9.5 Any agent can use the connector immediately. ## Assign connectors to an agent - Elastic Cloud Serverless: Preview - Elastic Stack: Planned An agent can only use the connectors you assign to it, and new agents start with none. You assign connectors from the agent after you save it. To assign connectors in Kibana, you need permission to edit the agent and the **Actions and Connectors: All** Kibana privilege. If **Enable Elastic capabilities** is off for the agent, also assign the built-in `connector-discovery` skill. Without it, the agent can't find its connectors. To assign a connector to an agent: 1. Select the agent. Then, in the sidebar under **Customize**, select **Connectors**. 2. Select **Add connector**. 3. Select one of the following: - **From library**: Assign connectors that already exist in the connectors library. - **Create new connector**: Configure a new connector. It's added to the library and assigned to the agent. To unassign a connector, remove it from the agent's **Connectors** page. The connector stays in the library, and other agents it's assigned to can still use it. Agents that were never assigned connectors can't use any. This includes: - The built-in **Elastic AI Agent**. - Agents created with the [Agents API](/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/kibana-api#agents-apis) without `connector_ids`. - Elastic Stack: Planned Agents created in 9.4 or 9.5 without a connector list. In those versions, these agents could use any connector. After you upgrade, assign connectors to them. - Elastic Cloud Serverless: Preview Existing agents without a connector list, including agents created before new agents started with an empty list. Previously, these agents could use any connector. Assign connectors to them. Agents that already had a connector list in 9.5 or on Serverless can now run only the connectors in that list. Previously, the list limited which connectors an agent could discover, not which ones it could run. Check these agents and assign any connectors they still need. ## Authorize connector access from chat - Elastic Cloud Serverless: Preview - Elastic Stack: Preview since 9.5 When an agent needs access to an OAuth connector, the chat pauses and displays an authorization prompt. Select **Authorize** to open the provider's sign-in flow in a new browser tab. After authorization succeeds, return to the chat, where the agent retries the connector call and continues. Select **Deny** to cancel the call. If authorization fails or the provider does not return you to Kibana, close the provider tab and select **Deny** in the chat. Correct the connector or OAuth configuration, then retry your request. To learn more about this prompt, refer to [Authorize a connector](/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/chat#authorize-a-connector). ## Related pages - [Tools in Elastic Agent Builder](https://www.elastic.co/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/tools) - [Skills in Elastic Agent Builder](https://www.elastic.co/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/skills) - [Plugins in Elastic Agent Builder](https://www.elastic.co/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/plugins) - [Custom agents](https://www.elastic.co/elastic/docs-builder/docs/4493/explore-analyze/ai-features/agent-builder/custom-agents)