> ## 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)

> [!NOTE]
>
> **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

***

## Getting Started

### Accessing Agent Connections

1. **Sign in to Agentspace**
   Log in to your Agentspace platform using your credentials.

   ![Sign in to Platform](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/1sigintoplatform.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=0133f215d326eda16463a8d25e6f882c)

   Sign in to Platform

2. **Navigate to My Agents**
   Click on **My Agents** from the left sidebar to view your available agents.

   ![Click to My Agents](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/2clicktomyagents.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=64097b886c57ee4bb41addf10f03dc16)

   Click to My Agents

3. **Select Your Agent**
   Click on the agent you want to configure connections for.

   ![Click to Agent](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/3clicktocoderagent.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=6055c77586f72e15f2f8a7ca0c809a09)

   Click to Agent

4. **Access Advanced Settings**
   In the agent details page, click on **Advanced** in the left sidebar menu.

   ![Click Advanced Menu](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/4inleftsideclickadvancedmenu.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=2c3ce306c6da2990f4a81b3156f78a70)

   Click Advanced Menu

5. **Navigate to Connections Section**
   Scroll down to find the **Connections** section where you can manage all external integrations.

   ![Go to Connections Section](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/5gotoconnectionssection.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=559d094c572abc278ab5670997aec548)

   Go to Connections Section

### Adding New Connections

1. **Click Add Connections**
   In the Connections section, click the **Add Connections** button to create a new connection.

   ![Click to Add Connections](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/6clicktoaddconnections.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=4c9c1ea523fff4e55a31801461895a35)

   Click to Add Connections

2. **Choose Connection Type**
   Select from the available connection types based on your integration needs.

   ![Connections You Can Make and Manage](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/8clickconnection.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=85cb3a483bb44b154b5784f5b6b89ef0)

   Connections You Can Make and Manage

3. **Complete Connection**
   Fill in the required credentials and configuration details for your selected platform. Once configured correctly, you'll see a success confirmation.

   ![Connected to Platform](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/9connectedtoplatform.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=ff72ac46d1bd6b46cdd3f8d181aaf0c1)

   Connected to Platform

***

## 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.

   ![Go to Topic Page to Add Action](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/10gototopicpagetoaddaction.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=48dbf835055077281bf0d2581da420d3)

   Go to Topic Page to Add Action

2. **Select Connected Service**
   In the action configuration, go to the Auth section and select **Use Connected Service** to leverage your established connection.

   ![In Auth Section Select Use Connected Service](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/11intheauthsectionselectuseconnectedservice.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=458afaa6bc952afe894e843394c44a97)

   In Auth Section Select Use Connected Service

3. **Choose Your Connection**
   Select the specific connection you want to use from the dropdown list of your available connections.

   ![Select Connection You Want to Use](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/12selectconnectionuwanttouse.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=fd674831359fd2b4330422bea2429c35)

   Select Connection You Want to Use

4. **Verify Connection Status**
   You can now see that your action is properly connected and ready to use the external service.

   ![You Can Now See It's Connected](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/13ucannowseeitsconnected.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=614b5ff3201ddf7b7161744948cac4d0)

   You Can Now See It's Connected

5. **Test the Connection**
   Use the test functionality to verify that your connection works properly with the configured action.

   ![Test Connection by Using Connection](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/14testconnectionbyusingconnection.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=00cd8789ba5fe4e1e87bdcc0463f006d)

   Test Connection by Using Connection

6. **Review Response**
   Check the response from your external service to ensure the connection and action are working as expected.

   ![See the Response](https://mintcdn.com/benchgen-8fc81371/2OCozHVviHUGu126/images/agentspace/connections/15seetheresponse.png?fit=max\&auto=format\&n=2OCozHVviHUGu126\&q=85\&s=47c6476538759f689bcca261fee4364f)

   See the Response


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.