跳转到主要内容

文档索引

获取完整文档索引： https://docs.crewai.com.cn/llms.txt

在深入了解之前，请使用此文件来浏览所有可用页面。

人机协同 (Human-in-the-Loop, HITL) 是一种强大的方法，它将人工智能与人类专业知识相结合，以增强决策并改善任务结果。CrewAI 根据您的需求提供了多种实现 HITL 的方式。

​
选择您的 HITL 方法

CrewAI 提供了两种实现人机协同工作流的主要方法
方法最适合集成方式版本
基于流程 (Flow-based) (使用 @human_feedback 装饰器)本地开发、基于控制台的审查、同步工作流流程中的人工反馈1.8.0+
基于 Webhook (Webhook-based) (企业版)生产环境部署、异步工作流、外部集成 (Slack、Teams 等)本指南-
如果您正在构建流程并希望添加基于反馈路由的人工审查步骤，请参阅 流程中的人工反馈 指南以了解 @human_feedback 装饰器。

​
设置基于 Webhook 的 HITL 工作流

1

配置您的任务

启用人工输入配置您的任务
Crew Human Input
2

提供 Webhook URL

启动您的 crew 时，包含一个用于接收人工输入的 webhook URL
Crew Webhook URL
使用 Bearer 认证的示例
curl -X POST {BASE_URL}/kickoff \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "topic": "AI Research"
    },
    "humanInputWebhook": {
      "url": "https://your-webhook.com/hitl",
      "authentication": {
        "strategy": "bearer",
        "token": "your-webhook-secret-token"
      }
    }
  }'
或使用 Basic 认证
curl -X POST {BASE_URL}/kickoff \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "topic": "AI Research"
    },
    "humanInputWebhook": {
      "url": "https://your-webhook.com/hitl",
      "authentication": {
        "strategy": "basic",
        "username": "your-username",
        "password": "your-password"
      }
    }
  }'
3

接收 Webhook 通知

当 crew 完成需要人工输入的任务后，您将收到一个包含以下内容的 webhook 通知
  • 执行 ID
  • 任务 ID
  • 任务输出
4

审查任务输出

系统将暂停在 等待人工输入 (Pending Human Input) 状态。请仔细审查任务输出。
5

提交人工反馈

使用以下信息调用您 crew 的恢复 (resume) 端点
Crew Resume Endpoint
关键提示：必须再次提供 Webhook URL：您必须在恢复调用中提供与启动调用时相同的 Webhook URL（taskWebhookUrl、stepWebhookUrl、crewWebhookUrl）。Webhook 配置不会从启动调用自动延续——它们必须在恢复请求中显式包含，才能继续接收关于任务完成、智能体步骤和 crew 完成的通知。
包含 webhook 的恢复调用示例
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"
  }'
反馈对任务执行的影响：提供反馈时务必小心，因为反馈的全部内容将被合并为后续任务执行的额外上下文。
这意味着
  • 反馈中的所有信息都将成为任务上下文的一部分。
  • 不相关的细节可能会对其产生负面影响。
  • 简洁、相关的反馈有助于保持任务的专注度和效率。
  • 在提交之前，请务必仔细审查您的反馈，确保仅包含能够积极引导任务执行的相关信息。
6

处理负面反馈

如果您提供负面反馈
  • crew 将结合您的反馈内容重新尝试该任务。
  • 您将收到另一个用于进一步审查的 webhook 通知。
  • 重复第 4-6 步，直到满意为止。
7

继续执行

当您提交正面反馈时，执行将进入后续步骤。

​
最佳实践

  • 保持具体：提供清晰、可操作的反馈，直接解决当前任务
  • 保持相关：仅包含有助于改进任务执行的信息
  • 及时响应：及时响应 HITL 提示，避免工作流延迟
  • 仔细审查：提交前请再次检查反馈，确保准确性

​
常见用例

HITL 工作流在以下场景中尤为有价值
  • 质量保证与验证
  • 复杂的决策场景
  • 敏感或高风险操作
  • 需要人类判断的创意任务
  • 合规性与监管审查

​
企业版功能

Flow HITL 管理平台

CrewAI 企业版为 Flow 提供了全面的 HITL 管理系统，包含平台内审查、响应者分配、权限、升级策略、SLA 管理、动态路由和完整分析。 了解更多 →