agently-tools

用途

Agently Tools 是 Agently 框架中面向工具系统的技能，用于在本地 Python 环境中注册、绑定与控制工具，并管理请求级别的工具循环。它聚焦工具注册、智能体作用域、循环控制、内置 Search/Browse/Cmd 的使用以及结果检查，不覆盖 MCP 传输注册、TriggerFlow 编排或通用 Web 服务设计。

主要能力

该技能覆盖以下内容：

• @agent.tool_func
• agent.register_tool(...)
• agent.use_tools(...)
• 内置 Search、Browse、Cmd
• set_tool_loop(...)
• 自定义 plan-analysis 或 tool-execution 处理器
• 单次模型请求产生的工具日志与工具结果

不适用于以下场景：

• MCP 服务器注册或 MCP 传输选择
• 以模型设置、输出 schema 设计或结构化流式输出为主要问题
• TriggerFlow 工作流设计
• FastAPI 服务暴露

使用方式

建议的工作流如下：

1. 选择工具应如何注册或绑定到智能体时，先阅读 references/registration-and-selection.md。
2. 问题涉及循环行为、轮数、并发、超时或自定义处理器时，阅读 references/tool-loop-and-control.md。
3. 任务需要使用 Search、Browse 或 Cmd 时，阅读 references/builtin-tools.md。
4. 任务涉及工具日志、动作结果或响应检查时，阅读 references/observability-and-results.md。
5. 若工具来自 MCP 服务器，切换到 agently-mcp。
6. 若任务变为工作流或多步编排问题，切换到 agently-triggerflow-playbook。
7. 若行为仍异常，使用 references/troubleshooting.md。

核心心智模型

Agently 工具是请求时的能力扩展：

• 工具注册在共享的工具管理器上
• agent.use_tools(...) 通过标签将选定的工具限定到某一个智能体
• 工具循环负责规划、执行，并将工具结果反馈回同一请求
• 最终响应会以元数据形式保留工具日志

工具工作应保持 async 优先：

• 优先使用异步工具函数
• 优先使用异步内置工具调用
• 显式限制工具循环的轮数和并发

选择规则

• 本地确定性 Python 辅助函数 → @agent.tool_func 或 register_tool(...)
• 将一个或多个已注册工具绑定到智能体 → use_tools(...)
• 使用现有辅助器暴露网页搜索、浏览或 shell 访问 → 内置工具
• 调整最大轮数、并发或超时 → set_tool_loop(...)
• 替换规划或执行策略 → 自定义 plan-analysis 或 execution 处理器
• 使用外部工具服务器替代本地 Python 函数 → agently-mcp

重要边界

• 工具循环是智能体/请求级能力，不能替代 TriggerFlow
• MCP 注册属于 agently-mcp，尽管 MCP 工具后续会参与同一工具循环
• 响应元数据与输出控制是独立关注点；当主要问题是响应消费时，应使用 agently-output-control

参考资料

• references/source-map.md
• references/registration-and-selection.md
• references/tool-loop-and-control.md
• references/builtin-tools.md
• references/observability-and-results.md
• references/troubleshooting.md

限制

前提条件为 Agently >= 4.0.8.5。关于安装方式、收费与价格、平台支持、具体效果以及未在资料中明确的使用步骤，暂未提供。