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

# Python Toolset

> Build connected agents with StackOne's Python AI SDK & Toolset

Build AI agents that connect to Salesforce, Workday, Slack, Gmail, HubSpot, and 200+ other business systems. The Python SDK integrates natively with LangChain, CrewAI, OpenAI Functions, LangGraph, and Pydantic AI. It includes dynamic tool discovery and search.

<Tip>
  **Not sure if the AI Toolset (SDK) is right for you?** Check out our [Agent Protocols Guide](/guides/calling-stackone-actions) to understand when to use AI Toolset (SDK) vs MCP vs A2A.
</Tip>

## Why StackOne?

<CardGroup cols={2}>
  <Card title="200+ Providers" icon="plug">Connect to Salesforce, Workday, Slack, Gmail, and more through one SDK</Card>
  <Card title="Multi-Tenant" icon="users">Built-in customer isolation with `account_id` for each connection</Card>
  <Card title="AI-Native" icon="robot">Tools designed for LLM function calling and agent frameworks</Card>
  <Card title="Consistent Data" icon="database">Normalized schemas: no provider-specific parsing needed</Card>
</CardGroup>

## How It Works

<Frame>
  <img src="https://mintcdn.com/stackone-60/wxt0YMtfLgBtb0Lo/images/agents/architecture-diagram.svg?fit=max&auto=format&n=wxt0YMtfLgBtb0Lo&q=85&s=254358a83f3c214f7ab4f4749cc632e7" alt="StackOne Architecture" width="800" height="320" data-path="images/agents/architecture-diagram.svg" />
</Frame>

Your agent connects to StackOne, which handles authentication and data normalization for 200+ SaaS providers like Salesforce, Workday, Slack, and more.

| Component          | Description                                                                |
| ------------------ | -------------------------------------------------------------------------- |
| **Your Agent**     | Built with LangChain, CrewAI, OpenAI, Vercel AI, or any framework          |
| **StackOne**       | AI Integration Gateway: handles auth, transforms data, manages connections |
| **SaaS Providers** | Salesforce, Workday, Greenhouse, Slack, Gmail, HubSpot, and 200+ more      |

## Key Concepts

* **Initialize a ToolSet**: Create a `StackOneToolSet` instance to access tools for providers like Workday, Greenhouse, Slack, and more
* **Filter Tools**: Use provider glob patterns like `"workday_*"`, `"slack_*"` or the `fetch_tools()` method for provider/action/account filters
* **Execute Tools**: Call provider APIs using `tool.call()` to list employees from Workday, send Slack messages, or create Jira tickets
* **Tool Search**: Discover relevant tools at runtime via natural language queries
* **Multi-Tenant**: Each tool execution requires an `account_id` to identify which customer's account to access

## Python Framework Integrations

<CardGroup cols={2}>
  <Card title="LangChain" href="/agents/python/frameworks/langchain-integration" icon="https://mintcdn.com/stackone-60/O2F4c3prhb0R9e5f/images/agents/langchain-logo.webp?fit=max&auto=format&n=O2F4c3prhb0R9e5f&q=85&s=8943521905cd027e58fade91dbb5aa36" width="300" height="300" data-path="images/agents/langchain-logo.webp">
    Build sophisticated agents with LangChain
  </Card>

  <Card title="CrewAI" href="/agents/python/frameworks/crewai-integration" icon="https://mintcdn.com/stackone-60/O2F4c3prhb0R9e5f/images/agents/crewai-logo.png?fit=max&auto=format&n=O2F4c3prhb0R9e5f&q=85&s=fea1f8fc99187fd08c0f628bd6b4c849" width="1024" height="1024" data-path="images/agents/crewai-logo.png">
    Multi-agent workflows and collaboration
  </Card>

  <Card title="OpenAI" href="/agents/python/frameworks/openai-integration" icon="https://mintcdn.com/stackone-60/zRAvvofCYLmP9UF6/images/agents/openai-logo.svg?fit=max&auto=format&n=zRAvvofCYLmP9UF6&q=85&s=a38c135695435b960bc6b40052de4ad0" width="16" height="16" data-path="images/agents/openai-logo.svg">
    Direct OpenAI function calling
  </Card>
</CardGroup>

## Python Core Features

<CardGroup cols={2}>
  <Card title="Tool Filtering" href="/agents/python/tool-filtering" icon="filter">
    Glob patterns plus provider/action filters with `fetch_tools()`
  </Card>

  <Card title="Tool Search" href="/agents/python/tool-search" icon="magnifying-glass">
    Discover tools using natural language queries
  </Card>

  <Card title="Installation" href="/agents/python/installation" icon="download">
    Set up the Python SDK
  </Card>

  <Card title="Basic Usage" href="/agents/python/basic-usage" icon="play">
    Core concepts and fundamental usage patterns
  </Card>
</CardGroup>

## Next Steps

1. [Learn about tool filtering](/agents/python/tool-filtering)
2. [Explore Tool Search](/agents/python/tool-search)

## Resources

* **[GitHub Repository](https://github.com/StackOneHQ/stackone-ai-python)**: Complete source code and examples
* **[Examples](https://github.com/StackOneHQ/stackone-ai-python/tree/main/examples)**: LangChain, CrewAI, and semantic search examples
* **[Issues](https://github.com/StackOneHQ/stackone-ai-python/issues)**: Report bugs or request features
* **[PyPI Package](https://pypi.org/project/stackone-ai/)**: Package details and version history