Agentic Workflow Patterns

代理工作流模式？

代理工作流模式是一个存储库，展示了用于在Python中构建多代理和代理工作流程的最佳实践和设计模式。该存储库强调模块化，可扩展和可重复使用的设计技术，旨在通过单代理和协作的多代理体系结构来促进智能自动化和稳健的工作流程管理。该存储库伴随着一篇介质文章，该文章深入深入介绍模式：设计认知架构：从头开始的代理工作流模式

目录

• 概述
• 模式概述
• 入门
• 安装
• 环境设置
• 用法
• 项目结构
• 贡献
• 执照

概述

该存储库提供了设计代理工作流程的示例和模板，这些工作流是由独立代理组成的工作流程，每个工作流程负责不同的任务。重点是创建可重复使用的组件，这些组件可以适用于各种自动化任务，从而实现智能决策和简化处理。

模式概述

模式1-反射

反射模式使用参与者批评的框架实现了迭代的内容生成和改进系统。这种模式通过演员（内容生成器）和评论家（内容审阅者）之间的连续反馈循环来实现自我改善的内容生成。

？此模式的所有代码都可以在此处找到。

模式2-网络访问

Web访问模式实现了用于检索，处理和汇总Web内容的代理工作流程。它策划了专门代理的管道，通过搜索，刮擦和总结操作来处理Web内容获取和处理的各个方面。

？此模式的所有代码都可以在此处找到。

图案3-语义路由

语义路由模式实现了基于语义意图的专用代理，以智能将用户查询将用户查询路由。这种模式使用协调员 - 贵族建筑，其中主要旅行计划确定用户的意图和路线请求，并要求专门的子代理，以完成与旅行相关的特定任务，例如飞行预订，酒店搜索和汽车租赁。

？此模式的所有代码都可以在此处找到。

模式4-平行授权

并行授权模式通过通过命名实体识别（NER）识别不同实体并将这些实体委派给专门的代理以进行并行处理来处理复杂的查询。这对于可以同时执行独立子任务的方案有效。

？此模式的所有代码都可以在此处找到。

图案5-动态碎片

动态碎片模式通过将工作负载动态分为较小，易于管理的碎片并并行处理，从而有效地处理大型数据集。通过使用Web搜索获取名人的传记（在模式2中讨论）来证明这种模式。

？此模式的所有代码都可以在此处找到。

模式6-任务分解

任务分解模式将复杂的任务分为独立的子任务，每个任务由单独的子任务代理管理。这种模式有益于提高效率和可扩展性。

？此模式的所有代码都可以在此处找到。

模式7-动态分解

动态分解模式使用大型语言模型（LLM）自主将复杂的任务分解为多个子任务，以生成由单独的代理处理的子任务。

？此模式的所有代码都可以在此处找到。

图案8- dag编排

DAG（定向的无环图）编排模式以灵活的方式管理复杂的工作流程，从而可以按指定顺序执行多个任务。它使用YAML定义的DAG来构建工作流程。

？此模式的所有代码都可以在此处找到。

入门

克隆这个存储库开始。该项目需要Python 3.8或更高版本。

先决条件

• Python 3.8+
• pip （带有Python 3.8+）

安装

1. 克隆存储库：

   git clone https://github.com/arunpshankar/Agentic-Workflow-Patterns.git
   cd Agentic-Workflow-Patterns

2. 设置虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # On Windows, use `.venvScriptsactivate`

3. 升级PIP和安装依赖项：

   pip install --upgrade pip
   pip install -r requirements.txt

设置凭据？

1. 在项目root中创建credentials夹：

   mkdir credentials

2. 设置GCP服务帐户凭据：

   • 转到Google Cloud Console（https://console.cloud.google.com/）。
   • 创建或选择现有项目。
   • 导航到“ API＆Services”>“凭据”。
   • 单击“创建凭据”>“服务帐户密钥”。
   • 选择JSON作为密钥类型，然后单击“创建”。
   • 将下载的JSON文件作为key.json保存在credentials夹中。

3. 设置SERP API凭据：

   • 通过https://serpapi.com/注册SERP API帐户。
   • 从仪表板获取API键。
   • 在credentials夹中创建一个名为key.yml的文件。
   • 添加您的SERP API令牌：

      serp :
       key : your_serp_api_key_here

注意： .gitignore中包含credentials夹，以防止敏感信息的投入。

环境设置？

要保持清洁的环境并禁用Python字节码生成，请配置以下环境变量：

 export PYTHONDONTWRITEBYTECODE=1
export PYTHONPATH= $PYTHONPATH :.

项目结构

• ./src/patterns/包含工作流模式的所有源代码。
• ./data/patterns/包含用于系统和用户提示的模板，结构化输出的JSON模式以及代理的输出（最终和中间）。

用法

设置环境后，您可以开始尝试此存储库中包含的工作流程模式。每种模式都记录在示例中，以证明其在建筑物代理工作流程中的应用。

例如，运行反射模式：

python src/patterns/reflection/pipeline.py

贡献？

我们欢迎并感谢捐款！这是对代理工作流模式做出贡献的方法：

1. 叉子存储库：在github上创建自己的叉子以独立进行更改。
2. 创建一个分支：在每个功能或修复的单独分支上工作。

   git checkout -b feature-branch-name

3. 进行更改：保持代码样式一致，并确保您的更改已得到充分记录。
4. 提交您的更改：写一个清晰简洁的提交消息。

   git commit -m " Add feature or fix description "

5. 提交拉动请求：推动更改并打开拉动请求。

指南

• 编码样式：遵循现有代码约定。
• 文档：确保您的代码和贡献有充分的记录。
• 测试：

添加测试（如果适用）以维持存储库稳定性。

• 问题报告：报告错误或通过问题提出功能。

执照

该存储库是根据MIT许可证获得许可的。有关详细信息，请参见许可证文件。