参与 CUGA 开源 AI Agent 社区贡献指南、项目路线图与社区支持完全介绍【免费下载链接】cuga-agentCUGA is an open-source generalist agent harness for the enterprise, supporting complex task execution on web and APIs, OpenAPI/MCP integrations, composable architecture, reasoning modes, and policy-aware features.项目地址: https://gitcode.com/gh_mirrors/cu/cuga-agentCUGA 是一款面向企业的开源通用 AI Agent 框架支持网页与 API 复杂任务执行、MCP/OpenAPI 工具接入、多智能体编排和策略治理。本文是一份面向新手的 CUGA 开源社区参与完全指南从本地跑通项目到提交你的第一个 PR再到项目路线图与社区支持渠道带你零基础上手。 CUGA 是什么企业级开源 Agent 框架速览CUGAConfigurable Generalist Agent的核心理念是先用通用 Agent 起步再为你的领域定制。它已在 AppWorld750 个真实任务、457 个 API和 WebArena 两大智能体基准上取得第一名的成绩。核心能力说明灵活工具接入通过 OpenAPI 规范、MCP 服务器、LangChain 接入 REST API 与 Python 函数推理模式可调fast / balanced / accurate 三档配置见src/cuga/settings.toml混合任务执行API 调用 浏览器操作Playwright 浏览器扩展无缝组合策略系统PoliciesIntent Guard、Playbook、Tool Approval 等 5 类策略 人工审批HITL知识库RAG内置 Docling 文档解析支持 agent 级与 session 级知识作用域多智能体协作CugaSupervisor 支持本地子代理与远程 A2A 代理CUGA 还深度集成了 Langflow 低代码平台你可以在可视化画布中拖拽 MCP 工具、模型节点把 CUGA 编排进任意工作流示例工程参考docs/examples/langflow/下附有完整的可视化工作流配置 JSON。 本地安装4 步跑通 CUGA 演示参与社区前强烈建议先本地跑起来——理解项目是贡献的前提。前置要求Python 3.12 和 uv 包管理器。# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/cu/cuga-agent cd cuga-agent # 2. 创建虚拟环境并安装依赖 uv venv --python3.12 source .venv/bin/activate uv sync # 3. 配置模型密钥创建 .env 文件 echo OPENAI_API_KEYyour-key-here .env # 4. 启动 CRM 演示浏览器自动打开 localhost:7860 cuga start demo_crm --read-only启动后试试这句话from contacts.txt show me which users belong to the crm system。另外cuga viz可以打开轨迹可视化面板观察 Agent 的决策与工具调用过程——这对后续做性能类贡献非常有帮助。 更多 LLM 平台配置OpenAI、Azure、WatsonX、Groq、Ollama 等见src/cuga/configurations/models/目录下的各平台 TOML 文件。 首次贡献路径6 步标准流程项目的完整贡献规范写在CONTRIBUTING.md核心流程可概括为 6 步Fork 仓库到你的账户CUGA 团队成员可跳过创建功能分支git checkout -b feature/short-topic分支名用小写字母 连字符如feature/add-login-page、bugfix/header-bug、release/v1.2.0保持 PR 小而专注建议单次改动少于 300 行、涉及文件数有限提交遵循 Conventional Commits格式为type(scope): 描述type 包括feat、fix、docs、refactor、test、chore等本地跑通格式化与测试见下文代码规范一节发起 PR从你的 fork 向main提交附清晰描述和检查清单结果3 个容易踩的坑 ⚠️DCO 签名仓库要求每个 commit 携带开发者原创证书签名。提交时加-s即可git commit -s -m feat(api): add list-accounts endpoint。已忘记签名可用git commit --amend --no-edit --signoff补救PR 标题即最终 commit所有 PR 以 Squash and merge 合并PR 标题会被直接用作提交信息务必按 Conventional Commits 格式认真写按类型选 PR 模板新功能用 feature 模板修 bug 用 bugfix 模板文档/维护类分别有 docs 和 chore 模板创建 PR 时界面会自动提示✅ 代码规范与测试让 CI 一次通过CUGA 的测试与 CI 约定在AGENTS.md中有详细说明新手重点记住这 3 条① 新测试必须打标记。每个测试都要用 pytest marker 声明类型Marker含义pytest.mark.unit快速、隔离的单元测试pytest.mark.e2e需要真实服务/完整 Agent 栈pytest.mark.stability基于 LLM 的稳定性回归pytest.mark.pgvector需要 pgvector 数据库pytest.mark.load/slow/manual压测 / 长耗时 / 需手动起服务② CI 按目录 标记发现测试。把新测试放进tests/unit/或tests/integration/即可被 CI 自动收集——不要往 workflow YAML 里加单个文件路径也不要手动编辑。③ 提交前的本地检查清单uv sync --dev uv run ruff format uv run ruff check --fix uv run pytest -m not stability and not pgvector and not manual and not e2e and not load另外仓库要求提交前运行 detect-secrets 安全扫描防止密钥等敏感信息意外入库具体命令见CONTRIBUTING.md的 Security Scanning 一节。 用 AI 助手加速贡献如果你用 Cursor、Claude 或 Bob 等 AI 辅助 IDE仓库已内置对应的贡献者技能位于.cursor/skills/、.claude/skills/、.bob/skills/涵盖规范提交、创建 PR、运行 ruff 等常见任务开箱即用。️ 项目路线图CUGA 接下来要做什么README 的 Roadmap 章节明确了两大探索方向也是社区贡献最可能被需要的领域策略Policy能力深化程序化 SOP、领域知识、输入/输出防护、基于上下文和工具的约束性能优化能根据任务复杂度动态调整的推理策略当前模式配置在src/cuga/configurations/modes/除此之外这些方向同样值得社区参与部署与自托管deployment/下提供 Helm Chart含 cuga、postgres-pgvector、vault、OpenShift 部署脚本和本地 Docker 部署脚本Kubernetes 部署指南见deployment/README.md评估体系如何评测 Agent 见src/cuga/evaluation/README.md文档与示例docs/examples/下有 MCP 接入、运行时工具、知识演示、旅行多智能体等完整示例工程补充新示例也是受欢迎的贡献类型 社区支持3 种参与方式无需写代码CUGA 团队的态度很明确可信赖的企业级 Agent 必须共同构建。即使不写代码你也有 3 条低门槛参与路径均可通过 Issue 提交分享使用场景Share use cases展示你在真实工作流中如何使用 CUGA请求新功能Request features建议能提升实用性的能力好的建议可能被直接排入路线图报告 BugReport bugs提交清晰、可复现的问题报告帮助提升项目稳定性遇到配置、调试等问题时可以优先查阅CONTRIBUTING.md的 IDE 调试配置Demo 模式会先启动 8001 端口的 API Registry再启动 7860 端口的 CUGA 服务、AGENTS.md的测试规范以及仓库docs/下的设计文档。结语从本地跑通一个演示到提交第一个 PRCUGA 社区为你准备了清晰的规范、AI 辅助技能和友好的 CI 约定。建议的新手路线是本地安装 → 跑通 demo_crm → 修一个文档小问题练手 → 按路线图认领一个功能。现在就克隆仓库开始你的第一次贡献吧【免费下载链接】cuga-agentCUGA is an open-source generalist agent harness for the enterprise, supporting complex task execution on web and APIs, OpenAPI/MCP integrations, composable architecture, reasoning modes, and policy-aware features.项目地址: https://gitcode.com/gh_mirrors/cu/cuga-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考