> ## Documentation Index
> Fetch the complete documentation index at: https://benchgen.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Connections

> Securely integrate your Agentspace agents with external platforms and services.

# Agent Connections

Agent Connections enable your UBOS Agentspace agents to securely integrate with external platforms and services. By establishing authenticated connections, your agents can access APIs, retrieve data, and perform actions across different systems while maintaining security and proper authorization.

***

## Overview

Agent Connections provide a centralized way to manage authentication and authorization for external integrations. This allows your agents to:

* Access third-party APIs with proper authentication
* Retrieve data from external databases and services
* Perform actions on behalf of users across different platforms
* Maintain secure, reusable connections across multiple agents
* Handle different authentication methods (API keys, JWT tokens, OAuth flows)

<Info>
  **Prerequisites**

  Before setting up connections, ensure you have:

  * An active Agentspace account
  * Administrative access to the external platforms you want to connect
  * The necessary credentials (API keys, client IDs, secrets) from those platforms
  * Understanding of the authentication method required by each service
</Info>

***

## Getting Started

### Accessing Agent Connections

1. **Sign in to Agentspace**
   Log in to your Agentspace platform using your credentials.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/1sigintoplatform.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=0133f215d326eda16463a8d25e6f882c" alt="Sign in to Platform" width="3248" height="1920" data-path="images/agentspace/connections/1sigintoplatform.png" />

2. **Navigate to My Agents**
   Click on **My Agents** from the left sidebar to view your available agents.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/2clicktomyagents.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=64097b886c57ee4bb41addf10f03dc16" alt="Click to My Agents" width="3256" height="1920" data-path="images/agentspace/connections/2clicktomyagents.png" />

3. **Select Your Agent**
   Click on the agent you want to configure connections for.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/3clicktocoderagent.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=6055c77586f72e15f2f8a7ca0c809a09" alt="Click to Agent" width="3248" height="1920" data-path="images/agentspace/connections/3clicktocoderagent.png" />

4. **Access Advanced Settings**
   In the agent details page, click on **Advanced** in the left sidebar menu.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/4inleftsideclickadvancedmenu.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=2c3ce306c6da2990f4a81b3156f78a70" alt="Click Advanced Menu" width="3256" height="1928" data-path="images/agentspace/connections/4inleftsideclickadvancedmenu.png" />

5. **Navigate to Connections Section**
   Scroll down to find the **Connections** section where you can manage all external integrations.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/5gotoconnectionssection.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=559d094c572abc278ab5670997aec548" alt="Go to Connections Section" width="3200" height="1892" data-path="images/agentspace/connections/5gotoconnectionssection.png" />

### Adding New Connections

1. **Click Add Connections**
   In the Connections section, click the **Add Connections** button to create a new connection.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/6clicktoaddconnections.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=4c9c1ea523fff4e55a31801461895a35" alt="Click to Add Connections" width="3248" height="1920" data-path="images/agentspace/connections/6clicktoaddconnections.png" />

2. **Choose Connection Type**
   Select from the available connection types based on your integration needs.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/8clickconnection.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=85cb3a483bb44b154b5784f5b6b89ef0" alt="Connections You Can Make and Manage" width="3248" height="1920" data-path="images/agentspace/connections/8clickconnection.png" />

3. **Complete Connection**
   Fill in the required credentials and configuration details for your selected platform. Once configured correctly, you'll see a success confirmation.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/9connectedtoplatform.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=ff72ac46d1bd6b46cdd3f8d181aaf0c1" alt="Connected to Platform" width="3248" height="1920" data-path="images/agentspace/connections/9connectedtoplatform.png" />

***

## Using Connections in Actions

Once your connection is established, you can use it within your agent's actions to interact with external services.

1. **Go to Topic Page**
   Navigate to your agent's Topics section where you can add actions that will use your connections.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/10gototopicpagetoaddaction.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=48dbf835055077281bf0d2581da420d3" alt="Go to Topic Page to Add Action" width="3260" height="1928" data-path="images/agentspace/connections/10gototopicpagetoaddaction.png" />

2. **Select Connected Service**
   In the action configuration, go to the Auth section and select **Use Connected Service** to leverage your established connection.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/11intheauthsectionselectuseconnectedservice.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=458afaa6bc952afe894e843394c44a97" alt="In Auth Section Select Use Connected Service" width="3260" height="1928" data-path="images/agentspace/connections/11intheauthsectionselectuseconnectedservice.png" />

3. **Choose Your Connection**
   Select the specific connection you want to use from the dropdown list of your available connections.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/12selectconnectionuwanttouse.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=fd674831359fd2b4330422bea2429c35" alt="Select Connection You Want to Use" width="3256" height="1924" data-path="images/agentspace/connections/12selectconnectionuwanttouse.png" />

4. **Verify Connection Status**
   You can now see that your action is properly connected and ready to use the external service.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/13ucannowseeitsconnected.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=614b5ff3201ddf7b7161744948cac4d0" alt="You Can Now See It's Connected" width="3256" height="1924" data-path="images/agentspace/connections/13ucannowseeitsconnected.png" />

5. **Test the Connection**
   Use the test functionality to verify that your connection works properly with the configured action.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/14testconnectionbyusingconnection.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=00cd8789ba5fe4e1e87bdcc0463f006d" alt="Test Connection by Using Connection" width="3240" height="1916" data-path="images/agentspace/connections/14testconnectionbyusingconnection.png" />

6. **Review Response**
   Check the response from your external service to ensure the connection and action are working as expected.
   <img src="https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/15seetheresponse.png?fit=max&auto=format&n=2OCozHVviHUGu126&q=85&s=47c6476538759f689bcca261fee4364f" alt="See the Response" width="3236" height="1912" data-path="images/agentspace/connections/15seetheresponse.png" />
