CrewAI 部署:从本地跑通到线上可调用的最短路径

发布时间:2026/8/30 14:02:16
CrewAI 部署:从本地跑通到线上可调用的最短路径 CrewAI 部署从本地跑通到线上可调用的最短路径【免费下载链接】crewAIFramework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.项目地址: https://gitcode.com/GitHub_Trending/cr/crewAI本地跑通的 Crew 想交给别人用你却卡在了部署这一步——打包、环境、密钥样样要操心。CrewAI 部署要解决的就是这件事把你本地开发好的 Crew 或 Flow 发布到 CrewAI AMP 平台变成一个能通过 API 调用的在线服务。 先分清你手里是 Crew 还是 Flow部署前不用背一堆概念先对照这张表确认自己属于哪类项目后面的校验规则全看它对比项Crew 项目Flow 项目核心目录src/项目名/下有crew.pysrc/项目名/下有crews/文件夹入口函数main.py里的run()main.py里的kickoff()pyproject.toml标记[tool.crewai]中type crewtype flow适用场景多个智能体分工共同完成一个目标显式编排的步骤式工作流 六步把环境备齐少走弯路部署校验会逐项检查以下内容按顺序做一遍后面大概率一次通过安装带工具的框架pip install crewai[tools]把 LLM 密钥如OPENAI_API_KEY和工具密钥写进项目.env名称要和代码里读取的完全一致。生成依赖锁文件并随代码提交——校验要求uv.lock或poetry.lock存在且不陈旧uv lock确认 crew 类带CrewBase装饰器否则平台找不到你的 Crew。本地先跑一遍确保它确实能跑crewai run从 0.103.0 起对 Crew 和 Flow 通用。登录平台终端会显示验证地址和短码浏览器里确认即完成认证crewai login️ 三种部署方式对号入座选一种你的场景选哪种项目在本地想手动控制每次发布CLI推荐下文细讲团队代码都在 GitHub 上不想碰命令行Web 界面连接仓库CI/CD 管道里自动重新部署AMP 的 REST API 触发推荐路径CLI。在项目根目录依次执行crewai deploy create它会读取本地配置并逐项跟你确认要一起带上去的环境变量如OPENAI_API_KEY这些密钥会随部署安全存储在平台侧所以执行前确保.env里的值是对的。crewai deploy status crewai deploy logs前者查询最近一次部署的状态如正在构建镜像已上线后者把构建日志实时打到终端卡住时先看它。发布后可用crewai deploy list查看历史crewai deploy remove删除。其余两种方式一句话带过Web 界面——把代码推到 GitHub在 AMP 里连接仓库、配好环境变量后点 Deploy 即可适合不想装 CLI 的团队API 方式——拿个人访问令牌在 AMP 的 Automations 里找到自动化 UUID向 deploy 端点发一个 POST 请求触发重新部署curl -i -X POST \ -H Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN \ https://app.crewai.com/crewai_plus/api/v1/crews/YOUR-AUTOMATION-UUID/deploy 上线之后怎么调用和管理平台会为部署生成唯一的 HTTPS 端点日常交互就靠这三个路由GET /inputs列出本次执行需要哪些输入参数POST /kickoff带上参数启动一次执行GET /status/{kickoff_id}轮询该次执行的状态Web 面板则负责人来看的部分查看部署信息和 API 端点详情以可视化方式查看 Crew 结构翻阅全部执行历史与性能指标下钻查看单次执行的详细跟踪 翻车速查四个高频故障构建早期就挂提示依赖解析错误→ 锁文件缺失或已过期 →uv lock后提交再部署。报找不到 Crew或配置读取异常→ crew 类漏了装饰器补上即可from crewai.project import CrewBase CrewBase class YourCrew: ...报找不到入口点或找不到模块→ 结构对不上Crew 的入口是run()Flow 的是kickoff()且pyproject.toml的type要与实际类型一致。启动后 LLM 连接失败、认证报错→ 平台侧环境变量名和代码不匹配 → 对照.env逐项核对 AMP 里配置的值。下一步挑一个你本地最小、最能跑的 Crew把上面六步和crewai deploy create完整走一遍卡住时先翻翻车速查再看仓库文档CLI 命令参考docs/edge/en/concepts/cli.mdxCrew 概念docs/edge/en/concepts/crews.mdxFlow 概念docs/edge/en/concepts/flows.mdx【免费下载链接】crewAIFramework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.项目地址: https://gitcode.com/GitHub_Trending/cr/crewAI创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考