docs/ai-agents/connectors/pylon/README.md
The Pylon agent connector is a Python package that equips AI agents to interact with Pylon through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.
Pylon is a customer support platform that helps B2B companies manage customer interactions across Slack, email, chat widgets, and other channels. This connector provides access to issues, accounts, contacts, teams, tags, users, custom fields, ticket forms, and user roles for customer support analytics and account intelligence insights.
The Pylon connector is optimized to handle prompts like these.
The Pylon connector isn't currently able to handle prompts like these.
uv pip install airbyte-agent-pylon
Connectors can run in open source or hosted mode.
In open source mode, you provide API credentials directly to the connector.
from airbyte_agent_pylon import PylonConnector
from airbyte_agent_pylon.models import PylonAuthConfig
connector = PylonConnector(
auth_config=PylonAuthConfig(
api_token="<Your Pylon API token. Only admin users can create API tokens.>"
)
)
@agent.tool_plain # assumes you're using Pydantic AI
@PylonConnector.tool_utils
async def pylon_execute(entity: str, action: str, params: dict | None = None):
return await connector.execute(entity, action, params or {})
In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead.
If your Airbyte client can access multiple organizations, also set organization_id.
This example assumes you've already authenticated your connector with Airbyte. See Authentication to learn more about authenticating. If you need a step-by-step guide, see the hosted execution tutorial.
from airbyte_agent_pylon import PylonConnector, AirbyteAuthConfig
connector = PylonConnector(
auth_config=AirbyteAuthConfig(
customer_name="<your_customer_name>",
organization_id="<your_organization_id>", # Optional for multi-org clients
airbyte_client_id="<your-client-id>",
airbyte_client_secret="<your-client-secret>"
)
)
@agent.tool_plain # assumes you're using Pydantic AI
@PylonConnector.tool_utils
async def pylon_execute(entity: str, action: str, params: dict | None = None):
return await connector.execute(entity, action, params or {})
This connector supports the following entities and actions. For more details, see this connector's full reference documentation.
| Entity | Actions |
|---|---|
| Issues | List, Create, Get, Update |
| Messages | List |
| Issue Notes | Create |
| Issue Threads | Create |
| Accounts | List, Create, Get, Update |
| Contacts | List, Create, Get, Update |
| Teams | List, Create, Get, Update |
| Tags | List, Create, Get, Update |
| Users | List, Get |
| Custom Fields | List, Get |
| Ticket Forms | List |
| User Roles | List |
| Tasks | Create, Update |
| Projects | Create, Update |
| Milestones | Create, Update |
| Articles | Create, Update |
| Collections | Create |
| Me | Get |
For all authentication options, see the connector's authentication documentation.
See the official Pylon API reference.