Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

End user connections

An end-user connection lets each person authorize the account an agent uses for them. Use this mode when results must come from the user's connected service account.

Before you start

Open an editable agent with a provider tool that offers Use end-user connection. Prepare a published interface and users with different source access and their own provider accounts. See Give an agent tools if the tool is not yet attached.

Configure the tool

Open the account-backed tool in the agent's configuration.

Agent tool connection settings

Define how the agent should use the returned information and whether it may change external records.

Set Connection to Use end-user connection.

Agent tool connection settings

The user of the published interface will then authorize the account used by that tool.

Review builder behavior

Review any builder connection fallback shown in the editor.

Builder connection fallback behavior

A builder run can use different authorization from the published end-user experience.

Prepare the published interface

Configure the user-facing interface and its access settings for the intended audience.

End-user interface access configuration

The end-user authorization prompt appears in that interface when a tool needs a connection.

Connect an end-user account

Open the interface as a user and submit a request that needs the tool.

End-user account authorization flow

Complete the provider authorization for that user's intended account.

Continue the request after authorization and inspect the returned result.

End-user account authorization flow

Confirm that the information comes from the connected user's account.

Review account-specific access

Repeat the flow in a separate user session when checking account-specific behavior.

Account-specific connection access checks

Authorize that user's own provider account rather than reusing another session's credentials.

Compare the results with the data accessible to each account.

Account-specific connection access checks

Different users should receive results appropriate to their own authorized connections.

Review connection ownership in the connector's inventory.

Account-specific connection access checks

Use the owner information to understand which user supplied each authorization.

Important behavior

A builder connection can differ from the account used in the published interface. Review access through the interface when the tool is configured for end-user connections.

Each end user authorizes their own provider account. Returned information depends on that account’s permissions.

Continue

Last updated

Was this helpful?