Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt

Use this file to discover all available pages before exploring further.

Without tools, your agent can only talk. Tools and connectors let your agent do things like sending emails, searching the web, creating calendar events, etc. Xpander has 2,000+ pre-built connectors for popular services like Slack, Google Drive, Salesforce, Jira, GitHub, and more. You can sign in using OAuth or provide API keys to connect your account and let your agent use these services. Connector catalog showing available integrations with connection counts This page covers:

Create a New Connection

Before your agent can use a connector, you need to create a connection. This authenticates your account with the external service. Each connector can have multiple connections (e.g., different Slack workspaces or different AWS accounts).
1

Choose a Connector from the catalog

Open the Agentic Connectors page and choose a connector you want to use (e.g., Calendly, Slack, Google Drive, Salesforce).This opens its Connector Actions list. Each action is a tool your agent can call once you’ve authenticated.You can see all actions grouped by category or as a flat list of API endpoints.
Calendly connector actions organized by group
2

Click + Create new connection

In the top right of the Connector Actions page, click + Create new connection.Enter connection details:
  • Name: Give the connection a descriptive name (e.g., “Marketing Team Slack”)
  • Access scope:
    • Personal (only you can use it), or
    • Organization (anyone in your workspace can use it)
Connection creation dialog with authentication method options
3

Choose an authentication method

Select the authentication method based on what the service supports:
  • Choose No authentication for public APIs that don’t require credentials
  • Choose API Key for services that use API keys or tokens
  • Choose OAuth 2.0 for services with own sign-in flow like Calendly, Slack, Google
  1. Select the No authentication tab
  2. Click Save
4

Manage your connections

After creating a connection, you can view and manage all connections for a connector by clicking connections in the top right of the connector’s detail page.
Connections modal showing saved connections with access scope and version
From here you can change the access scope, switch versions, or remove connections.

Create a Custom Connector

If the catalog doesn’t have what you need, for example, an internal tool API, you can create your own connector.
1

Click + Create new connector

In the top right of the Connectors Catalog page, click + Create new connector.
Connector catalog showing available integrations with connection counts
2

Provide connector details

  • Name: A descriptive name for your connector
  • Description: Optional context about what this connector does
  • OpenAPI specification or Postman collection: Upload a spec file (up to 50 MB)
  • API reference URL: Optional link to your API documentation
  • Server URL: The base URL for your API
Create new connector dialog with OpenAPI specification upload
3

Upload and generate

Click Create connector. Xpander will turn each endpoint in your API spec into a tool your agent can call.
4

Authenticate and use

Your custom connector now appears in the catalog. Create a connection to authenticate it (see Create a new connection above), then add its actions to your agents.

Add Tools to Your Agent

Once you’ve created connections, you can add tools to your agent. Tools come in two types: Built-in tools (pre-configured actions) and Connector tools (actions from authenticated services).
1

Open your agent's Tools tab

In the Agents page, select your agent to open its Agent Studio.
Agent Studio showing the chat interface and configuration controls
Click the gear icon in the top right, then go to the Tools tab.
Agent Tools tab showing built-in tools and Tools section
2

Enable built-in tools (optional)

Built-in tools are pre-configured actions that ship with every agent, no authentication or setup required.Click on any tool to toggle it on or off.
3

Add connector tools

Click + Add tools to open the connector browser panel. Click Connectors to see the full catalog. Or use the search to find a specific connector.
Add tools panel with the Connectors button highlighted

Connector catalog with search and categorized connectors
4

Select a connector and connection

Click a connector (e.g., Calendly) to see its available connections.
Calendly connector showing available connections
If you haven’t authenticated yet, you’ll see Create new connection. Click it to set one up (see Create a new connection above).Click an authenticated connection to see its available actions.
5

Select specific tools

Check the boxes next to the actions you want. Finally, click + Add to agent to attach them.
Selecting specific Calendly actions to add to the agent
Fewer tools means fewer decisions for the model, which means better accuracy. Only attach the actions your agent actually needs.
6

Verify and publish

The selected actions now appear under the Tools section in the config panel.
Tools tab showing added Calendly connector tool
You’ll see a banner: “Deploy changes to update tool configuration.” Click Publish in the top right to push changes live, or test your draft configuration in the embedded chat first.

Tool Dependencies

Without dependencies, an agent can call any tool in any order. Dependencies lock Tool B until the agent has called Tool A first, even if the user’s request only mentions Tool B. This is useful when one tool’s output is a prerequisite for another to work correctly. Even if the user says “book a meeting at 3pm,” the agent must call Get calendar availability before it can call Create calendar event. This guarantees the agent checks for conflicts before booking.

Create a dependency

Click + Manage dependencies at the top of the Tools tab to open the agent graph, a visual canvas showing every tool attached to your agent as a node. Manage dependencies modal showing the agent graph with tool nodes
1

Select the dependent tool

Click the top handle of the tool that must wait (the downstream tool).
2

Drag to the prerequisite tool

Drag to the bottom handle of the tool it depends on (the upstream tool). The dependency is created automatically.
3

Chain additional dependencies

Repeat to build multi-step sequences. You can also create branching paths where multiple tools depend on the same prerequisite, or where a tool requires multiple prerequisites to complete first.

Configure Max Tool Calls

Under Advanced Configuration in the Tools tab, you can limit the maximum number of tool calls per run. Advanced Configuration section with the Max tool calls per run limit field
Without a limit, an agent with many tools can enter runaway loops, calling tools indefinitely and consuming tokens. Set a cap appropriate for your use case.

Next steps

Knowledge Bases

Upload documents so your agent can search and cite them

AI Models & Intelligence

Planning mode, reasoning mode, and model selection

Agent Configuration

Full overview of all Agent Studio settings

Testing & Chat

Test your tools and debug behavior