工具系统总览

工具系统负责把“模型需要外部能力”这件事工程化。它不是单纯的函数调用，而是一套包含注册、规划、执行、结果注入和日志观测的回路。

适合什么时候读

• 你已经能跑通请求层，准备接外部能力
• 你要让模型调用搜索、浏览、命令或自定义工具
• 你需要理解 Tool Loop、工具日志和结果回填

你会学到什么

• Agently 的工具回路大致怎么工作
• 内置工具分别适合什么问题
• 工具调用失败时应该从哪里排查

工具回路概览

先看哪几页

• 想先跑通一轮：看 工具快速开始
• 想理解运行机制：看 工具运行流程（Tool Loop）
• 想替换默认 handler：看 工具 Handlers（默认与替换）

当前常用入口

• Search 搜索工具
• Browse 页面读取工具
• Cmd 命令执行工具
• MCP 工具接入

常见误区

• 只是需要一个固定外部 API，却先搭复杂工作流。
• 工具 schema、描述和参数都很模糊，却期待模型稳定调用。
• 工具调用失败后只看最终回答，不看 extra.tool_logs。

下一步去哪

• 要接现成 MCP Server：看 MCP 工具接入
• 要做更完整的外部能力系统：回到 工作流与扩展总览
• 要看真实工具 + TriggerFlow 组合：看 Daily News Collector

Related Skills（可选）

• agently-agent-extensions
• agently-playbook