主题
管理工作区管理
配置 Fleet 的工作区级设置。
配置工作区密钥,并管理 Fleet agent 和用户的支出限额。
工作区密钥
Fleet 使用工作区密钥来存储模型和工具的 API 密钥。以下密钥类型可用:
- 模型提供程序密钥:默认情况下,Fleet 使用由 LangChain 管理的模型,不需要模型提供程序的 API 密钥。仅当你使用自定义模型时,才需要 OpenAI 或 Anthropic API 密钥。设置后,agent 图会从工作区密钥中加载此密钥以进行推理。
- 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 服务器页面。
NOTE
自定义模型适用于企业部署。有关更多信息,请参阅自定义模型。
添加密钥
要添加密钥:
- 在 LangSmith UI 中,导航到
Settings,然后转到 Secrets 标签页。
- 选择 Add secret,输入密钥名称(例如
OPENAI_API_KEY或ANTHROPIC_API_KEY)以及作为值的密钥。
NOTE
确保密钥与模型提供程序期望的环境变量名称一致。
- 选择 Save secret。
用量和支出限额
Usage 页面让工作区管理员可以查看 Fleet 支出,并能够为 agent 和用户设置支出限额。此页面仅对拥有 fleet:read-admin-config 权限的用户可见。
查看当前支出
Usage 页面显示所选时间段(Last 7 days 或 Last 14 days)内工作区的总支出,以及总线程数和总运行数。
每日支出图表以可视化方式细分所选时间段内的成本。Breakdown 部分允许你通过两种方式查看支出详情:
- 按 agent:查看每个 agent 的总成本、运行数、首次和最后使用日期、所有者以及每周限额。
- 按用户:查看每个用户的支出和活动。
设置支出限额
支出限额让你可以控制 agent 和用户可以花费的金额。管理支出限额需要 fleet:write-admin-config 权限。
默认每周支出限额
在 Default Weekly Spend Limits 部分,你可以配置:
- Per-Agent Default Limit (USD):设置适用于工作区中所有 agent 的默认每周支出限额。
- Per-User Default Limit (USD):设置适用于工作区中所有用户的默认每周支出限额。
限额按周累计,并在每周一重置。
覆盖单个 agent 和用户的限额
你可以覆盖单个 agent 或用户的默认支出限额,以设置自定义的每周限额。
支出限额行为
- 支出限额的更改可能需要几分钟才能传播到所有正在运行的 agent。
- 支出限额在每次运行开始时检查。如果运行开始时用量低于限额,即使最终成本超过限额,该运行也会被允许完成。
- 支出计算基于追踪。删除追踪会影响报告的用量和支出执行。