Agency Swarm 开源项目教程

最新推荐文章于 2024-09-13 08:50:23 发布

樊蒙毅

最新推荐文章于 2024-09-13 08:50:23 发布

阅读量897

点赞数 25

本文链接：https://blog.csdn.net/gitblog_00967/article/details/142193313

版权

Agency Swarm 开源项目教程

agency-swarm An opensource agent orchestration framework built on top of the latest OpenAI Assistants API. 项目地址: https://gitcode.com/gh_mirrors/ag/agency-swarm

1. 项目介绍

Agency Swarm 是一个开源的代理编排框架，构建在最新的 OpenAI Assistants API 之上。该项目旨在简化代理创建过程，并使任何人都能创建具有不同角色和能力的协作代理群（Agencies）。通过将自动化视为现实世界中的实体，如机构和专门的代理角色，Agency Swarm 使得代理和用户的使用更加直观。

主要特点

可定制的代理角色：定义如 CEO、虚拟助理、开发者等角色，并使用 Assistants API 自定义其功能。
完全控制提示：避免预定义提示的冲突和限制，允许完全自定义。
工具创建：使用 Instructor 创建工具，提供便捷的接口和自动类型验证。
高效通信：代理通过基于自身描述的“发送消息”工具进行通信。
状态管理：Agency Swarm 高效管理 OpenAI 上的助手状态，维护在特殊的 settings.json 文件中。
可部署于生产环境：Agency Swarm 设计为可靠且易于部署在生产环境中。

2. 项目快速启动

安装

首先，使用 pip 安装 Agency Swarm：

pip install -U agency-swarm

设置 OpenAI API 密钥

from agency_swarm import set_openai_key
set_openai_key("YOUR_API_KEY")

创建工具

使用 Instructor 定义自定义工具：

from agency_swarm.tools import BaseTool
from pydantic import Field

class MyCustomTool(BaseTool):
    """A brief description of what the custom tool does."""
    example_field: str = Field(description="Description of the example field.")

    def run(self):
        """The implementation of the run method."""
        do_something(self.example_field)
        return "Result of MyCustomTool operation"

定义代理角色

from agency_swarm import Agent

ceo = Agent(
    name="CEO",
    description="Responsible for client communication, task planning and management",
    instructions="You must converse with other agents to ensure complete task execution",
    tools=[MyCustomTool],
    temperature=0.5,
    max_prompt_tokens=25000
)

定义机构通信流程

from agency_swarm import Agency

agency = Agency([
    ceo,
    [ceo, dev],
    [ceo, va],
    [dev, va]
], shared_instructions='agency_manifesto.md', temperature=0.5, max_prompt_tokens=25000)