如何用AgentForge设计多智能体工作流：Cogs YAML配置入门指南

如何用AgentForge设计多智能体工作流Cogs YAML配置入门指南【免费下载链接】AgentForgeExtensible AGI Framework项目地址: https://gitcode.com/gh_mirrors/ag/AgentForge想要快速构建复杂的AI智能体系统吗AgentForge的Cogs YAML配置让多智能体工作流设计变得简单直观 作为一款低代码AI框架AgentForge通过声明式YAML文件让您轻松编排智能体协作、记忆管理和分支逻辑无需编写复杂的Python代码。AgentForge是一个可扩展的AGI框架专为快速开发、测试和迭代AI驱动的自主智能体而设计。其核心概念包括灵活的智能体、声明式的Cogs和集成的记忆系统让您能够以最小的代码量实现从简单智能体到复杂多智能体系统的构建。什么是CogsCogs认知架构是AgentForge中的核心编排器通过YAML文件定义多智能体工作流。想象一下Cogs就像是一个智能的交通指挥系统它能够协调多个智能体的执行顺序管理智能体之间的数据传递实现基于决策的分支逻辑集成记忆系统保持上下文一致性防止无限循环确保工作流正常终止Cogs YAML配置基础结构每个Cog都是一个YAML文件存储在.agentforge/cogs/目录下。让我们从一个简单的例子开始cog: name: 简单分析工作流 description: 基础的分析流程示例 agents: - id: analyze template_file: analyze_agent - id: decide template_file: decide_agent - id: respond template_file: response_agent flow: start: analyze transitions: analyze: decide decide: choice: approve: respond reject: analyze fallback: respond max_visits: 5 respond: end: true这个配置定义了一个三步工作流分析 → 决策 → 响应。决策节点根据choice字段的值进行分支max_visits参数防止无限循环。智能体配置详解在agents部分您可以定义工作流中的各个智能体节点agents: - id: analyze template_file: analyze_agent - id: decide template_file: decide_agent每个智能体需要id: 唯一标识符用于在工作流中引用template_file: 对应的提示模板YAML文件名称type可选: 自定义智能体类的完整Python路径智能体模板文件位于src/agentforge/setup_files/prompts/目录下例如cog_analyze_agent.yaml、cog_decide_agent.yaml等。记忆系统集成AgentForge的强大之处在于其集成的记忆系统。您可以在Cog中声明记忆节点让智能体能够访问历史对话和相关信息memory: - id: general_memory query_before: [analyze] update_after: [respond] query_keys: [user_input] update_keys: [user_input, respond]记忆节点配置选项query_before: 在哪些智能体执行前查询记忆update_after: 在哪些智能体执行后更新记忆query_keys: 从上下文中提取哪些键进行查询update_keys: 将哪些数据存储到记忆中流程控制与分支逻辑flow部分是Cogs的核心它定义了工作流的执行顺序和分支逻辑简单线性流程flow: start: analyze transitions: analyze: decide decide: respond respond: end: true决策分支流程flow: start: analyze transitions: analyze: decide decide: choice: approve: respond reject: analyze fallback: respond max_visits: 3 respond: end: true决策分支的关键特性choice: 根据智能体输出中的字段值进行路由fallback: 当没有匹配项时的备用路径max_visits: 防止无限循环的安全机制智能体上下文访问在Cog工作流中智能体可以访问三种重要的上下文变量_ctx: 外部上下文如用户输入和运行时传递的值_state: 内部状态字典包含所有已执行智能体的输出_mem: 记忆管理器可以访问所有声明的记忆节点在提示模板中您可以这样使用这些变量prompts: user: context: | ## 用户输入 {_ctx.user_input} previous_analysis: | ## 之前的分析结果 {_state.analyze}实际应用示例让我们看一个完整的实际应用示例创建一个客户支持工作流cog: name: 客户支持工作流 description: 处理客户查询的多步骤支持流程 agents: - id: 理解问题 template_file: understand_agent - id: 分析问题 template_file: analyze_agent - id: 生成解决方案 template_file: solution_agent - id: 验证方案 template_file: validate_agent - id: 最终回复 template_file: response_agent memory: - id: 客户历史 query_before: [理解问题] update_after: [最终回复] query_keys: [customer_id, query_type] update_keys: [customer_id, query_type, solution, response] flow: start: 理解问题 transitions: 理解问题: 分析问题 分析问题: 生成解决方案 生成解决方案: choice: 需要验证: 验证方案 直接回复: 最终回复 fallback: 最终回复 验证方案: 最终回复 最终回复: end: true最佳实践建议1. 提示工程优化在提示模板中使用清晰的章节结构在上下文部分充分利用记忆系统保持提示简洁且具有指导性2. 分支决策设计始终在YAML中为分支名称添加引号设置合理的max_visits值通常3-5次为所有决策分支定义fallback路径3. 记忆管理策略使用query_before和update_after精确控制记忆使用时机明确指定query_keys和update_keys在提示中使用{_mem.node_id.readable}获取人类可读格式4. 聊天历史利用默认启用聊天历史记忆除非显式禁用配置chat_history_max_results控制近期对话数量使用{_mem.chat_history.history}访问对话历史调试与测试技巧AgentForge提供了强大的调试工具# 获取工作流执行轨迹 trail cog.get_track_flow_trail() print(trail) # 查看最终状态 result cog.run(context{user_input: 我的问题是什么}) print(result)您可以在tests/cog_tests/目录下找到完整的测试示例如test_example_cog.py和test_cog_trail_logging_and_flow_validation.py。进阶功能探索1. 自定义记忆类型除了基础记忆AgentForge还支持PersonaMemory: 角色记忆维护角色叙事ScratchpadMemory: 草稿记忆用于临时计算ChatHistoryMemory: 对话历史记忆自动启用2. 动态提示模板AgentForge支持运行时修改提示模板无需重启系统。这在快速迭代和A/B测试中非常有用。3. 多模型支持您可以为不同的智能体配置不同的LLM模型OpenAI GPT系列Google GeminiAnthropic Claude本地模型通过Ollama或LMStudio开始使用AgentForge要开始使用AgentForge的Cogs功能安装AgentForgepip install agentforge创建Cog配置文件 在.agentforge/cogs/目录下创建您的YAML文件定义智能体模板 在src/agentforge/setup_files/prompts/中创建对应的提示模板运行工作流from agentforge import AgentForge forge AgentForge() cog forge.load_cog(your_cog_name) result cog.run(context{user_input: 您的输入})总结AgentForge的Cogs YAML配置为您提供了一个强大而灵活的框架来设计多智能体工作流。通过声明式配置您可以 快速构建复杂的工作流无需编写大量代码 实现智能的分支逻辑和循环控制 集成强大的记忆系统保持上下文一致性 轻松调试和测试工作流执行 支持多种LLM模型灵活适配不同场景无论您是AI新手还是经验丰富的开发者AgentForge都能帮助您快速实现智能体系统的构建和迭代。现在就开始使用Cogs YAML配置释放多智能体协作的无限潜力吧想要了解更多详细信息请查阅官方文档中的Cogs指南和智能体配置。【免费下载链接】AgentForgeExtensible AGI Framework项目地址: https://gitcode.com/gh_mirrors/ag/AgentForge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考