CrewAI

CrewAI 是用于构建多 Agent 系统的框架，涵盖 Agent、任务、团队、流程、工具和记忆。AISIX 位于模型请求边界，而 CrewAI 继续负责 Agent 协作和任务执行。

CrewAI 文档中适合网关的路径是使用带自定义 base_url 的 LLM 配置。当 CrewAI 应用需要通过 AISIX 发送兼容 OpenAI 的聊天请求时，请使用此设置。

本指南使用带自定义 LLM 的 CrewAI。你将使用 AISIX 代理 URL、调用方 API Key 和模型别名配置 LLM。

前置条件

开始前，请准备以下内容：

• 一个受 CrewAI 支持的 Python 环境。
• 一个正在运行且应用可以访问的 AISIX 网关。
• 一个 AISIX 调用方 API Key。
• 一个调用方 API Key 可通过兼容 OpenAI 的 API访问的模型别名。

如果你的组织已经部署 AISIX，请向管理团队获取网关 URL、模型别名和调用方 API Key。否则，请按照开源 AISIX 网关快速上手或 AISIX Enterprise 快速上手完成部署，也可以联系 API7申请 AISIX Cloud 访问权限。

配置 CrewAI

如果应用尚未包含 CrewAI，请先安装：

pip install crewai

设置 CrewAI 应用要使用的值：

# AISIX_BASE_URL 以 /v1 结尾，末尾不带斜杠
# 本地快速入门使用 http://127.0.0.1:3000/v1
export AISIX_BASE_URL="YOUR_AISIX_GATEWAY_URL/v1"
export AISIX_API_KEY="YOUR_CALLER_API_KEY"
export AISIX_MODEL="gpt-4o-prod"

使用 AISIX 值创建 CrewAI LLM，并将其传递给 Agent：

import os

from crewai import Agent, Crew, LLM, Task

llm = LLM(
  model=os.environ["AISIX_MODEL"],
  provider="openai",
  api_key=os.environ["AISIX_API_KEY"],
  base_url=os.environ["AISIX_BASE_URL"],
)

writer = Agent(
  role="Writer",
  goal="Write concise explanations.",
  backstory="You explain technical systems clearly.",
  llm=llm,
)

task = Task(
  description="Write one sentence about governed multi-agent systems.",
  expected_output="One concise sentence.",
  agent=writer,
)

crew = Crew(
  agents=[writer],
  tasks=[task],
)

print(crew.kickoff())

模型值应填写 AISIX 模型别名，而不是上游服务提供方模型 ID。provider 值指示 CrewAI 使用兼容 OpenAI 的客户端访问自定义端点。AISIX 管理模型请求路径，而 CrewAI 继续负责 Agent、任务、团队、流程、记忆和工具编排。

验证集成

在已设置 AISIX 环境变量的 Shell 中运行脚本。

请求成功后，请确认以下结果：

• 脚本输出团队结果。
• AISIX 为所选模型别名记录一条或多条成功的 POST /v1/chat/completions 请求。

请在 AISIX 网关日志中验证请求。也可以使用已配置的指标或上游服务提供方日志。

如果请求失败，请先确认调用方 API Key 可以访问所选模型别名，且 base_url 指向包含 /v1 的 AISIX 代理 API 根路径。

多 Agent 工作流可能因规划、委派、工具使用、记忆和任务执行而发起多次模型调用。为每个应使用 AISIX 的 Agent 或团队级 LLM 配置 AISIX，并在配置限流和审查用量时考虑额外请求。使用 AISIX Enterprise 或 AISIX Cloud 时，还应在设置预算时考虑这些请求扇出。

CrewAI 目前没有为这里所示的 base_url 路径记录稳定的原生 OpenAI Responses API 等效配置。除非所用 CrewAI 版本提供并记录了 Responses API 客户端路径，否则请继续使用 AISIX 的兼容 OpenAI 路由。如果确实提供，请在切换生产流量前验证实际的 Agent、工具和记忆工作流。

后续步骤

• 兼容 OpenAI 的 API：查看面向网关的请求行为。
• 工具调用：在启用 CrewAI 工具前确认工具调用行为。
• 预算：在控制面支出控制中考虑多 Agent 请求扇出。