 生成 Connect Link 并完成聊天外的预授权)
如何在 Composio 会话中用 session.authorize() 生成 Connect Link 并完成聊天外的预授权【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio如果你的 Agent 用户在开始聊天前就应该完成账号授权——例如 onboarding 流程、设置页连接管理或在任务执行前做连接预检——Composio 提供了session.authorize()方法它在会话上按需生成一条 Connect Link托管授权页 URL你负责把该链接引导给用户授权完成后再校验连接状态。本文基于仓库中的 Manual auth management 文档 和相关 SDK 参考给出从创建会话到验证连接的完整操作路径适用于 Python 与 TypeScript 两种 SDK。前置条件已安装 Composio SDK并拥有 Composio API keyPython 中通过Composio(api_key...)传入TypeScript 中通过new Composio({ apiKey: ... })传入一个稳定的user_idAuthentication 文档 要求使用数据库主键或 UUID 这类不会变化的标识避免使用邮箱生产环境禁止使用default要预授权的 toolkit slug例如gmail、github。创建会话并生成 Connect Link在会话上调用session.authorize(toolkit_slug)返回一个 connection request 对象其中的redirect_urlPython/redirectUrlTypeScript就是 Connect Link。session composio.create(user_iduser_123) connection_request session.authorize(gmail) print(connection_request.redirect_url) # https://connect.composio.dev/link/ln_abc123import { Composio } from composio/core; const composio new Composio({ apiKey: your_api_key }); const session await composio.create(user_123); const connectionRequest await session.authorize(gmail); console.log(connectionRequest.redirectUrl); // https://connect.composio.dev/link/ln_abc123上例输出中的ln_abc123为文档示例实际链接每次生成时不同。把这个 URL 交给用户——可以渲染在你自己的连接 UI 里、发邮件或在设置页展示——用户打开后在 Composio 托管页面上完成登录凭据不经过你的应用或模型。等待授权完成wait_for_connection拿到 redirect URL 后用同一个 connection request 对象等待用户完成授权connected_account connection_request.wait_for_connection(60000) print(fConnected: {connected_account.id})const connectedAccount await connectionRequest.waitForConnection(60000); console.log(Connected: ${connectedAccount.id});该方法会持续轮询 Composio API直到连接进入ACTIVE状态返回 connected account、进入FAILED或EXPIRED等终态抛出错误或超过超时时间抛出超时错误。文档说明默认超时为 60 秒上面的代码块展示了显式传入参数等待的用法。控制授权完成后的回跳地址默认情况下用户授权后停留在 Composio 页面。如果要把用户带回你的应用在authorize()传入callback_url/callbackUrl并可以自带 query 参数携带上下文connection_request session.authorize( gmail, callback_urlhttps://your-app.com/callback?user_iduser_123sourceonboarding )const connectionRequest await session.authorize(gmail, { callbackUrl: https://your-app.com/callback?user_iduser_123sourceonboarding, });授权完成后Composio 会保留你已有的参数并追加两个参数再重定向到该地址ParameterDescriptionstatussuccess或failedconnected_account_id新创建的 connected account 的 ID文档示例示例结果实际值不同https://your-app.com/callback?user_iduser_123sourceonboardingstatussuccessconnected_account_idca_abc123在你的回调页读取status与connected_account_id即可区分授权成功或失败并把 account ID 记录到自己的数据库中。验证连接状态除了等待方法本身的返回值还可以用session.toolkits()查看会话内所有 toolkit 及其连接状态作为预授权流程的核对手段toolkits session.toolkits() for toolkit in toolkits.items: status toolkit.connection.connected_account.id if toolkit.connection.is_active else Not connected print(f{toolkit.name}: {status})const toolkits await session.toolkits(); toolkits.items.forEach((toolkit) { console.log(${toolkit.name}: ${toolkit.connection?.connectedAccount?.id ?? Not connected}); });输出中能看到对应 toolkit 的 connected account ID 说明已连接否则显示Not connected。注意只有ACTIVE状态的连接可用于执行工具如果连接停留在INITIATED说明用户打开了 Connect Link 但没有完成授权——此时需要重新引导用户访问该链接完成认证。关闭聊天内授权提示把授权完全交给自己的 UI会话默认包含COMPOSIO_MANAGE_CONNECTIONSmeta-tool会在聊天中提示用户授权。既然你要做聊天外的预授权应把它关掉避免两套授权入口并存session composio.create( user_iduser_123, manage_connectionsFalse, )const session await composio.create(user_123, { manageConnections: false, });完整流程预检必备 toolkit 再启动 Agent文档给出的典型模式是在启动 Agent 前检查所有必需连接缺哪个补授权哪个。以下代码块来自文档your-api-key与user_123需替换为你自己的 API key 和用户标识from composio import Composio composio Composio(api_keyyour-api-key) required_toolkits [gmail, github] session composio.create( user_iduser_123, manage_connectionsFalse, # Disable in-chat auth prompts ) toolkits session.toolkits() connected {t.slug for t in toolkits.items if t.connection.is_active} pending [slug for slug in required_toolkits if slug not in connected] print(fConnected: {connected}) print(fPending: {pending}) for slug in pending: connection_request session.authorize(slug) print(fConnect {slug}: {connection_request.redirect_url}) connection_request.wait_for_connection() print(All toolkits connected!)import { Composio } from composio/core; const composio new Composio({ apiKey: your-api-key }); const requiredToolkits [gmail, github]; const session await composio.create(user_123, { manageConnections: false, // Disable in-chat auth prompts }); const toolkits await session.toolkits(); const connected toolkits.items .filter((t) t.connection?.connectedAccount) .map((t) t.slug); const pending requiredToolkits.filter((slug) !connected.includes(slug)); console.log(Connected:, connected); console.log(Pending:, pending); for (const slug of pending) { const connectionRequest await session.authorize(slug); console.log(Connect ${slug}: ${connectionRequest.redirectUrl}); await connectionRequest.waitForConnection(); } console.log(All toolkits connected!);TypeScript 版本中connected的判定基于connection?.connectedAccount是否存在而 Python 版本基于is_active两者语义略有差异以你实际使用的 SDK 为准。边界与已知状态用户关闭 Connect Link 未完成授权时连接保持在INITIATED状态直到过期Authenticating Tools 文档 说明INITIATED状态的连接会在 10 分钟后自动过期之后需要重新生成 Connect Link。wait_for_connection抛出错误时对应连接进入终态如FAILED或超时FAILED的常见原因包括用户在 OAuth 中拒绝授权、授权码无效或 auth config 配置错误可检查status_reason字段后重试。若某个 toolkit 的授权流程需要额外参数如 Zendesk 的subdomainsession.authorize()之外的直接 SDK 路径composio.connected_accounts.link()/composio.connectedAccounts.link()支持传入更完整的 auth 配置参见 Authenticating Tools。仓库中还有一个更精简的官方示例Python 版 authorize.py创建限定github、gmail的会话后调用session.authorize(github)并等待连接成功打印 Connected Account ID 与 Status失败打印错误和 TypeScript 版 authorize.ts。完成上述流程后session.toolkits()中目标 toolkit 显示已连接、回调地址收到statussuccess即代表聊天外预授权完成之后可以正常创建 Agent 会话开始对话。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何在 Composio 会话中用 session.authorize() 生成 Connect Link 并完成聊天外的预授权【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio如果你的 Agent 用户在开始聊天前就应该完成账号授权——例如 onboarding 流程、设置页连接管理或在任务执行前做连接预检——Composio 提供了session.authorize()方法它在会话上按需生成一条 Connect Link托管授权页 URL你负责把该链接引导给用户授权完成后再校验连接状态。本文基于仓库中的 Manual auth management 文档 和相关 SDK 参考给出从创建会话到验证连接的完整操作路径适用于 Python 与 TypeScript 两种 SDK。前置条件已安装 Composio SDK并拥有 Composio API keyPython 中通过Composio(api_key...)传入TypeScript 中通过new Composio({ apiKey: ... })传入一个稳定的user_idAuthentication 文档 要求使用数据库主键或 UUID 这类不会变化的标识避免使用邮箱生产环境禁止使用default要预授权的 toolkit slug例如gmail、github。创建会话并生成 Connect Link在会话上调用session.authorize(toolkit_slug)返回一个 connection request 对象其中的redirect_urlPython/redirectUrlTypeScript就是 Connect Link。session composio.create(user_iduser_123) connection_request session.authorize(gmail) print(connection_request.redirect_url) # https://connect.composio.dev/link/ln_abc123import { Composio } from composio/core; const composio new Composio({ apiKey: your_api_key }); const session await composio.create(user_123); const connectionRequest await session.authorize(gmail); console.log(connectionRequest.redirectUrl); // https://connect.composio.dev/link/ln_abc123上例输出中的ln_abc123为文档示例实际链接每次生成时不同。把这个 URL 交给用户——可以渲染在你自己的连接 UI 里、发邮件或在设置页展示——用户打开后在 Composio 托管页面上完成登录凭据不经过你的应用或模型。等待授权完成wait_for_connection拿到 redirect URL 后用同一个 connection request 对象等待用户完成授权connected_account connection_request.wait_for_connection(60000) print(fConnected: {connected_account.id})const connectedAccount await connectionRequest.waitForConnection(60000); console.log(Connected: ${connectedAccount.id});该方法会持续轮询 Composio API直到连接进入ACTIVE状态返回 connected account、进入FAILED或EXPIRED等终态抛出错误或超过超时时间抛出超时错误。文档说明默认超时为 60 秒上面的代码块展示了显式传入参数等待的用法。控制授权完成后的回跳地址默认情况下用户授权后停留在 Composio 页面。如果要把用户带回你的应用在authorize()传入callback_url/callbackUrl并可以自带 query 参数携带上下文connection_request session.authorize( gmail, callback_urlhttps://your-app.com/callback?user_iduser_123sourceonboarding )const connectionRequest await session.authorize(gmail, { callbackUrl: https://your-app.com/callback?user_iduser_123sourceonboarding, });授权完成后Composio 会保留你已有的参数并追加两个参数再重定向到该地址ParameterDescriptionstatussuccess或failedconnected_account_id新创建的 connected account 的 ID文档示例示例结果实际值不同https://your-app.com/callback?user_iduser_123sourceonboardingstatussuccessconnected_account_idca_abc123在你的回调页读取status与connected_account_id即可区分授权成功或失败并把 account ID 记录到自己的数据库中。验证连接状态除了等待方法本身的返回值还可以用session.toolkits()查看会话内所有 toolkit 及其连接状态作为预授权流程的核对手段toolkits session.toolkits() for toolkit in toolkits.items: status toolkit.connection.connected_account.id if toolkit.connection.is_active else Not connected print(f{toolkit.name}: {status})const toolkits await session.toolkits(); toolkits.items.forEach((toolkit) { console.log(${toolkit.name}: ${toolkit.connection?.connectedAccount?.id ?? Not connected}); });输出中能看到对应 toolkit 的 connected account ID 说明已连接否则显示Not connected。注意只有ACTIVE状态的连接可用于执行工具如果连接停留在INITIATED说明用户打开了 Connect Link 但没有完成授权——此时需要重新引导用户访问该链接完成认证。关闭聊天内授权提示把授权完全交给自己的 UI会话默认包含COMPOSIO_MANAGE_CONNECTIONSmeta-tool会在聊天中提示用户授权。既然你要做聊天外的预授权应把它关掉避免两套授权入口并存session composio.create( user_iduser_123, manage_connectionsFalse, )const session await composio.create(user_123, { manageConnections: false, });完整流程预检必备 toolkit 再启动 Agent文档给出的典型模式是在启动 Agent 前检查所有必需连接缺哪个补授权哪个。以下代码块来自文档your-api-key与user_123需替换为你自己的 API key 和用户标识from composio import Composio composio Composio(api_keyyour-api-key) required_toolkits [gmail, github] session composio.create( user_iduser_123, manage_connectionsFalse, # Disable in-chat auth prompts ) toolkits session.toolkits() connected {t.slug for t in toolkits.items if t.connection.is_active} pending [slug for slug in required_toolkits if slug not in connected] print(fConnected: {connected}) print(fPending: {pending}) for slug in pending: connection_request session.authorize(slug) print(fConnect {slug}: {connection_request.redirect_url}) connection_request.wait_for_connection() print(All toolkits connected!)import { Composio } from composio/core; const composio new Composio({ apiKey: your-api-key }); const requiredToolkits [gmail, github]; const session await composio.create(user_123, { manageConnections: false, // Disable in-chat auth prompts }); const toolkits await session.toolkits(); const connected toolkits.items .filter((t) t.connection?.connectedAccount) .map((t) t.slug); const pending requiredToolkits.filter((slug) !connected.includes(slug)); console.log(Connected:, connected); console.log(Pending:, pending); for (const slug of pending) { const connectionRequest await session.authorize(slug); console.log(Connect ${slug}: ${connectionRequest.redirectUrl}); await connectionRequest.waitForConnection(); } console.log(All toolkits connected!);TypeScript 版本中connected的判定基于connection?.connectedAccount是否存在而 Python 版本基于is_active两者语义略有差异以你实际使用的 SDK 为准。边界与已知状态用户关闭 Connect Link 未完成授权时连接保持在INITIATED状态直到过期Authenticating Tools 文档 说明INITIATED状态的连接会在 10 分钟后自动过期之后需要重新生成 Connect Link。wait_for_connection抛出错误时对应连接进入终态如FAILED或超时FAILED的常见原因包括用户在 OAuth 中拒绝授权、授权码无效或 auth config 配置错误可检查status_reason字段后重试。若某个 toolkit 的授权流程需要额外参数如 Zendesk 的subdomainsession.authorize()之外的直接 SDK 路径composio.connected_accounts.link()/composio.connectedAccounts.link()支持传入更完整的 auth 配置参见 Authenticating Tools。仓库中还有一个更精简的官方示例Python 版 authorize.py创建限定github、gmail的会话后调用session.authorize(github)并等待连接成功打印 Connected Account ID 与 Status失败打印错误和 TypeScript 版 authorize.ts。完成上述流程后session.toolkits()中目标 toolkit 显示已连接、回调地址收到statussuccess即代表聊天外预授权完成之后可以正常创建 Agent 会话开始对话。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
