Integrations

Not OnPrem

Integrations on the aiXplain platform allow you to securely connect external services - like Slack, Gmail, or Airtable, to your agents. These integrations power real-world task execution via natural language prompts.

List Available Integrations

Use IntegrationFactory to explore all available integrations:

from aixplain.factories import IntegrationFactory

IntegrationFactory.list()

Show output

This helps you find available integrations like ZoomInfo, Slack, Notion, Airtable, and more.

Set Up an Integration

1. Go to Discover → Integrations tab.

2. Search and select your desired integration.

3. Click the integration card.

4. Connect with your account.

5. Once authenticated, the card updates to show your linked account.

Use the Integration Tool

To use an integration tool, retrieve the tool with ToolFactory and tool ID.

slack_tool = ToolFactory.get("67eff5c0e05614297caeef98")
slack_tool

Using Integrations in Agents

Each integration provides a set of actions (e.g., Slack supports sending a message, creating a channel, etc.). Each action comes with its own parameters — some required, some optional. To use integrations effectively, scope only the actions your agent needs. This reduces hallucinations and keeps behavior predictable.

List and filter actions

You can list all actions or filter down to a specific action by its code.

# List all available actions for the Slack tool
slack_tool.actions

# Filter down to a specific action by its code
slack_tool.action_scope = [action for action in slack_tool.actions if action.code == "SLACK_CHAT_POST_MESSAGE"]

Show output

Check action parameters

Before using an action, inspect which parameters it requires.

This will show fields like:

• channel_id (required)
• text (required)
• attachments (optional)

action = slack_tool.action_scope[0]
slack_tool.get_action_inputs(action)

Show output

Scope actions

You should scope actions to only those your agent truly needs. This ensures the agent doesn’t attempt irrelevant calls.

slack_tool.action_scope = [action for action in slack_tool.actions if action.code == "SLACK_CHAT_POST_MESSAGE"]

Add an action to your agent

Now you can add the Slack tool with its scoped actions to an agent.

from aixplain.factories import AgentFactory

agent = AgentFactory.create(
  name="Slack Notifier",
  description="This agent sends notifications to Slack.",
  instructions="You can send messages to Slack channels.",
  tools=[slack_tool],
)
response = agent.run("""
Notify channel '#demo_channel' that our meeting will be canceled.
""")
print(response.data.output)

Show output

Security & Compliance (Composio Integrations)

When using an integration via Composio, all credentials are securely stored within Composio’s infrastructure. The platform maintains SOC 2 Type II and ISO compliance and enforces encryption at rest and in transit.