Agent capabilities
Connectors let an agent use your accounts in other services as tools.
Connect an account once per workspace, include it on a harness, and the agent works in that service on the task's behalf.
What they are
A connector links a workspace to an account in another service, such as GitHub, Microsoft 365 or Stripe, and gives the workspace's agents that service's actions as tools. The list also holds the browser, web search and on-demand tools.
Apps is a connector of its own: a catalog of apps that a person connects with their own account, signing in through a pop up.
Turning them on
- Open Add-on, then the Plugins tab, and press Connect on the row you want.
- In Apps, press Connect beside an app and sign in to it. The first app you connect in a workspace turns Apps on there.
- Include the connector on each harness that should use it, in the harness's Settings, under Capabilities, Plugins.
GET /v1/plugs the connectors in this workspace and whether each is connected
GET /v1/apps the apps that can be connected
POST /v1/apps/{slug}/connect a link to open in a pop up, where the person signs in
GET /v1/apps/connections the apps connected in this workspace
DELETE /v1/apps/connections/{id} disconnect one
POST /v1/harnesses/{id}/servers/plugs {"plugs": ["github"]} sets a harness's whole connector listWhat it costs
Connectors cost nothing extra. A task that uses one is billed like any other task. On-demand tools are the exception, billed per run.
- On-demand toolsPaid tools the agent finds and runs as a task needs them.
Errors
Including connectors on a harness replaces its whole list, so send every connector it should keep.
- 409 apps_no_account
- The app has no account to connect.
- 409 apps_refused
- The app cannot be connected here.
- 503 apps_refused
- The app's service is busy or down. Try again in a moment.
What they do not do
- A workspace's connections never reach another workspace.
- Disconnecting stops the account's use at once. A stored credential is never returned by any endpoint.
Ready to run this against a live workspace?Create API key