HITL 工作流

Human-In-The-Loop（HITL）是一种强大的方法，它将人工智能与人工专业知识结合起来，以增强决策并改善任务结果。本指南将展示如何在 CrewAI Enterprise 中实现 HITL。

CrewAI 中的 HITL 方法

CrewAI 提供两种实现 human-in-the-loop 工作流的方法：

方法	最适合	版本
基于 Flow（`@human_feedback` 装饰器）	带 Enterprise UI 的生产环境、邮件优先工作流、完整平台功能	1.8.0+
基于 Webhook	自定义集成、外部系统（Slack、Teams 等）、旧有配置	所有版本

使用 Enterprise 平台的基于 Flow 的 HITL

在 Flow 中使用 @human_feedback 装饰器时，CrewAI Enterprise 会提供一个邮件优先的 HITL 系统，让任何拥有电子邮件地址的人都可以回复审查请求：

邮件优先设计

回复者会收到电子邮件通知，并可直接回复，无需登录。

仪表板审查

如有需要，可在 Enterprise 仪表板中审查并响应 HITL 请求。

灵活路由

可以根据方法模式将请求路由到特定邮箱，或者从 flow state 中提取邮箱。

自动响应

当在超时时间内没有人工回复时，可以配置自动回退响应。

主要优势

外部回复者：任何有电子邮件的人都可以回复，即使不是平台用户
动态分配：可从 flow state 中提取指派邮箱，例如 account_owner_email
配置简单：基于电子邮件的路由比用户/角色管理更容易设置
部署创建者兜底：如果没有匹配的路由规则，则通知部署创建者

设置基于 Webhook 的 HITL 工作流

对于与 Slack、Microsoft Teams 或你自己的应用等外部系统的自定义集成，你可以使用基于 webhook 的方式：

配置你的任务

为任务启用人工输入：
提供 Webhook URL

启动 crew 时，包含用于人工输入的 webhook URL：
接收 Webhook 通知

一旦 crew 完成需要人工输入的任务，你会收到包含以下信息的 webhook 通知：
- Execution ID
- Task ID
- Task output
审查任务输出

系统会暂停在 Pending Human Input 状态。请仔细审查任务输出。
提交人工反馈

使用以下信息调用 crew 的 resume 端点：

Warning

重要：Webhook URL 必须再次提供：你必须在 resume 调用中提供与 kickoff 调用中相同的 webhook URL（taskWebhookUrl、stepWebhookUrl、crewWebhookUrl）。Webhook 配置不会从 kickoff 自动继承 - 要继续接收任务完成、智能体步骤和 crew 完成的通知，必须在 resume 请求中显式包含它们。

带 webhook 的 resume 调用示例：
Terminal window
```
curl -X POST {BASE_URL}/resume \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "execution_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
    "task_id": "research_task",
    "human_feedback": "Great work! Please add more details.",
    "is_approve": true,
    "taskWebhookUrl": "https://your-server.com/webhooks/task",
    "stepWebhookUrl": "https://your-server.com/webhooks/step",
    "crewWebhookUrl": "https://your-server.com/webhooks/crew"
  }'
```
Warning

反馈对任务执行的影响：在提供反馈时务必谨慎，因为整段反馈内容都会作为后续任务执行的额外上下文。

这意味着：
- 你的反馈中的所有信息都会成为任务上下文的一部分。
- 无关细节可能会对其产生负面影响。
- 简洁且相关的反馈有助于保持任务聚焦并提高效率。
- 在提交前务必仔细检查反馈，确保只包含能正向指导任务执行的相关信息。
处理负面反馈

如果你提供负面反馈：
- crew 会结合你的反馈中的新上下文重试任务。
- 你会收到另一条 webhook 通知以便进一步审查。
- 重复第 4-6 步，直到满意为止。
继续执行

当你提交正面反馈后，执行会继续进入下一步。