代理身份控制使用谁的 凭据 代理在与应用和服务交互时使用的凭据。

固定凭据（"Claws"）

无论谁在与其交互，代理始终使用相同的 API 密钥和 OAuth 令牌进行身份验证。

在以下情况下使用固定凭据：

• - 代理作为共享服务运行（例如，团队 Slack 机器人或每日简报代理）。
• - 您希望为所有用户使用一组已认证账户。
• - 代理需要在 频道 or 日程上运行，这需要固定凭据。

使用固定凭据时，代理执行的所有操作（发送电子邮件、发布消息、读取日历）都使用代理所有者在设置期间连接的账户。

用户凭据（"Assistants"）

代理使用与其交互的用户的 API 密钥和 OAuth 令牌进行身份验证，代表用户执行操作。

在以下情况下使用用户凭据：

• - 每位用户都应通过自己的账户进行操作（例如，读取和发送用户自己的收件箱中的邮件的电子邮件助手）。
• - 您需要按用户进行访问控制，以便代理只能看到该用户有权访问的内容。
• - 审计日志需要反映每个操作由哪个用户执行。

使用用户凭据时，每位用户首次与代理交互时都需单独进行身份验证。代理在该用户的线程中使用该用户的令牌执行所有后续操作。

设置代理身份

要为代理设置身份：

1. 在 LangSmith UI中，导航到您要编辑的代理。
2. 点击 **编辑** 在右上角。
3. 点击 **设置身份** 并选择您要使用的身份。
4. 点击 **保存**.