启动 Crew

​

概览

将 Crew 部署到 CrewAI 企业版平台后，您可以通过 Web 界面或 API 启动执行。本指南涵盖了这两种方法。

​

方法 1：使用 Web 界面

​

步骤 1：导航至您已部署的 Crew

1. 登录 CrewAI 企业版
2. 从项目列表中点击 Crew 名称
3. 您将被带到该 Crew 的详情页面

​

步骤 2：启动执行

从 Crew 的详情页面，您有两种启动执行的方式

​

选项 A：快速启动

1. 在“测试端点 (Test Endpoints)”部分点击 Kickoff 链接
2. 在 JSON 编辑器中输入您的 Crew 所需的输入参数
3. 点击 发送请求 (Send Request) 按钮

​

选项 B：使用可视化界面

1. 在 Crew 详情页面点击 运行 (Run) 标签页
2. 在表单字段中输入所需的输入
3. 点击 运行 Crew (Run Crew) 按钮

​

步骤 3：监控执行进度

启动执行后

1. 您将收到包含 kickoff_id 的响应 - 复制此 ID
2. 此 ID 对于跟踪您的执行至关重要

​

步骤 4：检查执行状态

要监控您的执行进度

1. 在“测试端点 (Test Endpoints)”部分点击“状态 (Status)”端点
2. 将 kickoff_id 粘贴到指定字段中
3. 点击“获取状态 (Get Status)”按钮

状态响应将显示

• 当前的执行状态（running、completed 等）
• 正在进行中的任务的详细信息
• 目前已产生的任何输出

​

步骤 5：查看最终结果

执行完成后

1. 状态将变为 completed
2. 您可以查看完整的执行结果和输出
3. 如需更详细的视图，请查看 Crew 详情页面的 执行记录 (Executions) 标签页

​

方法 2：使用 API

您还可以使用 CrewAI 企业版 REST API 以编程方式启动 Crews。

​

认证

所有 API 请求都需要 bearer token 进行认证

curl -H "Authorization: Bearer YOUR_CREW_TOKEN" https://your-crew-url.crewai.com

您的 bearer token 在 Crew 详情页面的“状态 (Status)”标签页上可用。

​

检查 Crew 健康状态

在执行操作之前，您可以验证您的 Crew 是否正常运行

curl -H "Authorization: Bearer YOUR_CREW_TOKEN" https://your-crew-url.crewai.com

成功的响应将返回一条消息，指示 Crew 正在运行

Healthy%

​

步骤 1：检索所需输入

首先，确定您的 Crew 需要哪些输入

curl -X GET \
  -H "Authorization: Bearer YOUR_CREW_TOKEN" \
  https://your-crew-url.crewai.com/inputs

响应将是一个 JSON 对象，包含一个所需输入参数的数组，例如

{"inputs":["topic","current_year"]}

此示例显示该特定的 Crew 需要两个输入：topic 和 current_year。

​

步骤 2：启动执行

提供所需输入以启动执行

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_CREW_TOKEN" \
  -d '{"inputs": {"topic": "AI Agent Frameworks", "current_year": "2025"}}' \
  https://your-crew-url.crewai.com/kickoff

响应将包含一个 kickoff_id，您需要使用它进行跟踪

{"kickoff_id":"abcd1234-5678-90ef-ghij-klmnopqrstuv"}

​

步骤 3：检查执行状态

使用 kickoff_id 监控执行进度

curl -X GET \
  -H "Authorization: Bearer YOUR_CREW_TOKEN" \
  https://your-crew-url.crewai.com/status/abcd1234-5678-90ef-ghij-klmnopqrstuv

​

处理执行

​

长时间运行的执行

对于可能需要很长时间的执行

1. 考虑实现轮询机制来定期检查状态
2. 使用 webhooks（如果可用）在执行完成时接收通知
3. 实现错误处理以应对潜在的超时

​

执行上下文

执行上下文包括

• 启动时提供的输入
• 部署期间配置的环境变量
• 任务之间维护的任何状态

​

调试失败的执行

如果执行失败

1. 检查“执行记录 (Executions)”标签页以获取详细日志
2. 查看“跟踪 (Traces)”标签页以获取逐步执行详情
3. 在跟踪详情中查找 LLM 响应和工具使用情况