# 08 Agent 和工具调用

## 学习目标

你将理解 Agent 的适用边界，以及如何让工具调用更可控。

## Agent 是什么

Agent 的核心是让模型根据目标和上下文，决定下一步要不要调用工具、调用哪个工具、如何解释结果。

这适合信息来源不固定、步骤不完全固定的任务。但它也意味着成本、延迟和不确定性更高。

## 什么时候用 Agent

适合：

- 用户问题差异很大。
- 需要查询多个外部来源。
- 工具调用顺序无法提前完全确定。
- 需要模型做一定规划。

不适合：

- 固定审批流程。
- 严格合规流程。
- 可以用 Workflow 清楚表达的任务。
- 工具调用错误会造成严重后果的任务。

## Prompt 要写清楚工具边界

官方 Agent 文档强调，Prompt 应说明角色、输出格式、限制、工具使用方式和工作流程。对 Agent 来说，工具说明尤其重要。

示例：

```text
你是内部运营助手。

你可以使用以下工具：
- search_docs：查询公司公开制度。
- create_ticket：创建工单。

规则：
1. 只有当用户明确要求提交问题时，才调用 create_ticket。
2. 涉及制度问题时，先调用 search_docs。
3. 如果 search_docs 没有找到依据，不要编造。
4. 创建工单前，必须向用户确认标题、描述和紧急程度。
```

## 工具类型

Dify 支持多种工具形态：

- 插件工具：由 Dify 或社区提供，常见服务可直接安装。
- OpenAPI 工具：通过标准 OpenAPI 描述接入内部或第三方服务。
- Workflow as Tool：把以 User Input 开始的 Workflow 封装成工具，供其他应用复用。
- MCP 工具：通过 Model Context Protocol 接入外部资源和工具。

## 最大迭代次数

Agent 可能多次“思考、调用工具、处理结果”。最大迭代次数越高，复杂任务能力越强，但延迟和成本也会上升。

新手建议：

- 简单工具任务：2 到 3 次。
- 多源查询任务：3 到 5 次。
- 复杂研究任务：谨慎提高，并观察成本。

## 工具描述

工具描述不要只写“查询数据”。要说明：

- 工具能做什么。
- 什么时候用。
- 输入参数是什么。
- 不能用于什么场景。
- 失败时怎么处理。

## 常见错误

- 工具描述太模糊，Agent 不知道何时调用。
- 没有限制敏感操作。
- 没有确认步骤就创建、删除或提交。
- 用 Agent 代替本来固定的 Workflow。
- 最大迭代次数过高导致成本不可控。

## 本章练习

设计一个“会议安排 Agent”：

- 能查询日历。
- 能查询同事资料。
- 能生成会议议程。
- 创建会议前必须向用户确认。