Skip to main content

Connected account selection

Discovered integration tools depend on the connected accounts and provider schemas. A completed tool call can represent a request to connect rather than completion of the requested business action.

Discovered tool schemas​

Tool names, arguments and result shapes come from the enabled integration. The optional component-action mode exposes component keys and exports/ret outputs; other modes can differ. Some account-dependent inputs or missing required fields are supplied only after an attempted call. Use the discovered schema and actual error; do not hardcode a Slack, GitHub or calendar action's fields into a generic connected-app handler.

Multiple account selection​

Run Connect again to add another account for the same app. When discovery sees multiple accounts, the app's tools require x_account_id with an allowed account ID. With one account, the integration binds that account without the extra selector.

The discovered list can be up to a minute old. Recheck the connection when a call fails, and do not treat an account still appearing in a list as consent for a new action. Recurring work needs particular care: the current API does not provide a control that preserves the intended account consent across connection changes.

Account connection tools​

The pd_list_accounts and pd_connect_account tools bypass allowlistToolPatterns, but a blocklist matching pd_* or * excludes them. Include that distinction when deciding whether this assistant may initiate a connection flow.

Unconnected app results​

An unconnected app can still expose tools. Calling one may return a connect link with TOOL_EXECUTION_STATUS_COMPLETED; that status does not mean the requested calendar action happened. The model can omit the link from its answer.

Connection-link answer deadline​

The run has a bounded wait: read clientToolDeadlineAt and configure toolPolicy.clientToolTimeoutMs for the interaction. The default is five minutes. If the user cannot finish in time, report the unsuccessful attempt and let them continue through your normal connection screen.