Skip to main content

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

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

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

  4. Access Advanced Settings
    In the agent details page, click on Advanced in the left sidebar menu. 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

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

  2. Choose Connection Type
    Select from the available connection types based on your integration needs: 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

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

  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

  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

  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

  5. Test the Connection
    Use the test functionality to verify that your connection works properly with the configured action. 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

Pro Tips
  • Start with read-only connections to test integration safely
  • Use connection templates for common service types
  • Implement retry logic for transient connection failures
  • Document connection dependencies for each agent

Next Steps​

After setting up your connections:

  1. Create Actions that utilize these connections
  2. Test the integration thoroughly
  3. Monitor connection usage and performance
  4. Set up alerts for connection issues

For more information on using connections in your agents: