让Agent代表用户安全连接第三方数据工具

目标

只用用户明确授权的scope访问第三方数据，不向Agent暴露长期凭据。

步骤

1. 确认工具代表单一用户访问的资源，以及服务商支持的OAuth scope。 [auth]
2. 用 AuthConfig(auth_scheme=..., raw_auth_credential=..., credential_key="documents_api") 声明OAuth需求，并向CredentialManager配置credential service。 [auth]
3. 检测授权中断事件后引导用户到服务商同意页，不把token放进模型消息。 [auth]
4. 收到回调后校验state与用户绑定，将凭证安全传回等待中的工具并限制有效期。 [auth]

验证方式

授权仅覆盖请求scope；错误state、过期或其他用户token均被拒绝，日志不含token。

故障处理

若恢复后工具重复请求授权，核对回调续跑时传回了正确授权结果且session属于同一用户。