> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 工作流工具

> 让智能体将已部署的工作流作为工具运行

# 工作流工具

工作流工具允许智能体在一次智能体运行期间调用已部署的工作流端点变体。

## 概述

当智能体需要把任务的一部分交给已有的工作流处理时,请添加工作流工具。Fetch Hive 会将工作流作为普通的工作流运行启动,因此它会拥有自己的请求 ID、工作流运行 ID、工作流日志和步骤追踪。父智能体也会将该调用记录为智能体工具 span,工作流追踪在智能体运行追踪中嵌套在该工具调用下。

工作流工具使用所选工作流端点变体的最新活动版本。工具输入模式由工作流的起始输入声明生成,因此模型可以传入与工作流通过 API 调用所期望的相同顶层输入。

## 如何添加工作流工具?

1. 在智能体编辑器中打开父智能体。
2. 点击编辑器顶部的添加工具按钮。
3. 从 **Workflow Tools** 中选择一个已部署的工作流端点和变体。
4. 输入模型应当看到的工具名称和描述。
5. 保存该工具。

工作流端点和变体必须与智能体属于同一工作区。工具名称在智能体的 MCP 工具、工作流工具和子智能体之间必须唯一。

## 会记录什么?

每次工作流工具调用都会创建两条相互关联的记录:

* 一次普通的工作流运行,具有自己的请求 ID 和工作流运行 ID。
* 一次父智能体工具调用,其元数据用于标识工作流工具和子工作流运行。

你可以像检查任何其他工作流调用一样,从工作流日志中检查子工作流。在智能体追踪中,父工具 span 名为 `agent.tool.workflow`,子工作流 span 附加在该 span 之下。

## 何时应使用工作流工具?

当被委派的工作已经建模为工作流时,使用工作流工具,尤其是当它包含多个确定性步骤、分支、集成或可重用的工作流专属日志时。当被委派的工作应由另一个拥有自己的指令和工具集的智能体处理时,使用子智能体。