配置工作区密钥,并管理 Fleet 代理和用户的支出限额。

工作区密钥

Fleet 使用工作区密钥存储模型和工具的 API 密钥。以下是可用的密钥类型:
  • 模型提供商密钥:默认情况下,Fleet 使用由 LangChain 管理的模型,不需要模型提供商 API 密钥。仅当你使用自定义模型时,才需要 OpenAI 或 Anthropic API 密钥。设置后,代理图会从工作区密钥中加载此密钥以进行推理。
  • Fleet 专用密钥:在 Fleet 中,以 FLEET_ 为前缀的密钥优先于工作区密钥。这样,你可以更好地跟踪 Fleet 与 LangSmith 中使用相同密钥的其他部分之间的使用情况。如果同时存在 OPENAI_API_KEY 和 FLEET_OPENAI_API_KEY,系统将使用 FLEET_OPENAI_API_KEY 密钥。
  • 可选工具密钥:为启用的工具添加相应密钥。这些密钥会在运行时从工作区密钥中读取。
    • EXA_API_KEY:Exa 搜索工具(常规网页搜索和 LinkedIn 个人资料搜索)所需。
    • TAVILY_API_KEY:Tavily 网页搜索所需。
    • TWITTER_API_KEY 和 TWITTER_API_KEY_SECRET:Twitter/X 读取操作所需(仅限应用级 bearer)。不支持发帖和媒体上传。
  • MCP 服务器配置:Fleet 可以从一个或多个远程 Model Context Protocol (MCP) 服务器获取工具。在工作区设置中配置 MCP 服务器和标头。Fleet 会自动发现工具,并在调用工具时应用已配置的标头。有关更多信息,请参阅远程 MCP 服务器页面。
企业部署支持自定义模型。有关更多信息,请参阅自定义模型。

添加密钥

添加密钥:
  1. 在 LangSmith UI 中,转到 设置,然后切换到 密钥 标签页。
  2. 选择 添加密钥,输入密钥的名称(例如 OPENAI_API_KEY 或 ANTHROPIC_API_KEY),并将你的密钥输入为值。
    确保密钥与模型提供商要求的环境变量名称一致。
  3. 选择 保存密钥。

使用量和支出限额

使用量页面让工作区管理员能够查看 Fleet 的支出,并为代理和用户设置支出限额。此页面仅对拥有 fleet:read-admin-config 权限的用户可见。

查看当前支出

使用量页面会显示工作区在所选时间段(过去 7 天或过去 14 天)内的总支出,以及线程总数和运行总数。 每日支出图表会直观展示所选时间段内的费用明细。明细部分支持通过以下两种方式查看支出详情:
  • 按代理:查看每个代理的总费用、运行次数、首次和最后使用日期、所有者以及每周限额。
  • 按用户:查看每位用户的支出和活动情况。

设置支出限额

支出限额可帮助你控制代理和用户的支出金额。管理支出限额需要 fleet:write-admin-config 权限。

默认每周支出限额

在 默认每周支出限额 部分,你可以配置:
  • 每个代理的默认限额(USD):设置适用于工作区内所有代理的默认每周支出限额。
  • 每个用户的默认限额(USD):设置适用于工作区内所有用户的默认每周支出限额。
限额按本周累计计算,并在每周一重置。

为单个代理和用户覆盖限额

你可以为单个代理或用户覆盖默认支出限额,设置自定义的每周限额。

支出限额行为

  • 支出限额的更改可能需要几分钟才能同步到所有正在运行的代理。
  • 支出限额会在每次运行开始时检查。如果运行开始时使用量低于限额,即使最终费用超过限额,运行也会继续完成。
  • 支出计算基于追踪记录。删除追踪记录会影响报告中的使用量和支出限额执行。