osFoundry / Platform
工具配置
以输入 + 处理器形式定义新工具。任何您能从 Maestro 调用的内容皆可。
简介
工具配置是你教会 osFoundry 智能体去做内置功能无法完成之事的方式。一个工具配置就是由两部分组成的小型定义：它接受的输入（带名称的参数及其类型），以及一个 handler（工具被调用时真正运行的内容）。一旦定义完成，这个工具就加入到 osFoundry 智能体运行时 Maestro 在工作时可调用的手段集合中，就像它使用聊天、搜索或文件操作一样。只要你能把一个动作描述为「这些是参数，这些是要运行的内容」，就能把它变成智能体按名称调用的工具。
在 osFoundry 中，这一功能位于 Studio 内，与你的其余智能体和工作流配置并列，因此你定义的工具可供你在同一工作区中构建的智能体、循环和团队使用。由于 osFoundry 采用 bring-your-own-key 且本地优先，handler 从你的工作区出发、用你自己的凭据和密钥运行：在你的智能体与它调用的服务之间没有任何转售方，也没有按席位限制你能定义多少工具或它们运行多频繁。输入 schema 是模型用来判断何时以及如何调用工具的依据，因此一组清晰的命名输入正是让智能体正确使用它的关键；而 handler 则是你从头到尾掌控的部分。
为何重要：真实的智能体工作大多依赖于你自身技术栈特有的动作，比如访问内部 API、运行脚本，或从只有你能访问的系统中拉取数据。与其等待某项功能来覆盖每一种情况，工具配置让你恰好添加所需的能力，并让 Maestro 立即使用它。工具由此成为可复用的积木：定义一次，工作区中的每个智能体或工作流都能调用它。
主要功能
- 用两部分定义一个工具：它接受的输入，以及被调用时运行的 handler
- 带名称、带类型的输入为模型给出何时以及如何调用工具的清晰约定
- 你定义的任何工具都能被 osFoundry 智能体运行时 Maestro 按名称调用
- Handler 从你自己的工作区、用你自己的密钥运行：BYOK，路径中没有转售方
- 在同一个 Studio 中构建的智能体、循环和团队之间复用已定义的工具
使用场景
- 开发者：把内部 REST 端点封装成带类型输入的工具，让智能体在任务中查询它，而无需把调用写死
- 运维工程师：定义一个 handler 运行维护脚本的工具，再让一个定时智能体把它作为常规步骤来调用
- 团队负责人：在 Studio 中添加一个自定义查询工具，并在工作区的每个智能体和工作流中复用，而不必为每个智能体重复搭建
常见问题
osFoundry 中的工具配置到底是什么？
它是由两部分组成的定义：工具接受的输入（带名称、带类型的参数），以及工具被调用时运行的 handler。定义之后，该工具便可供 Maestro 在智能体工作时调用。
工具的 handler 能做什么？
Handler 是调用时运行的动作。其核心原则是：只要是你能从 Maestro 调用的东西，都可以成为一个工具。你定义智能体传入的输入，handler 则使用你的工作区和你自己的凭据来完成工作。
这与托管平台的插件有何不同？
osFoundry 采用 bring-your-own-key 且本地优先，因此工具是从你的工作区、用你的密钥运行，而非经由转售方，也没有按席位收费来限制你能定义多少个。你直接添加所需能力，而不必等待某项内置功能去覆盖它。