终极指南：如何使用AgentScope从零构建分布式多智能体AI应用

【免费下载链接】agentscope 项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope

AgentScope是一个功能强大且易于使用的多智能体平台，专为构建分布式AI应用而设计。它提供了丰富的工具和组件，让开发者能够快速搭建复杂的智能体系统，实现智能体间的高效协作与通信。无论是开发聊天机器人、自动化工作流还是复杂的多智能体系统，AgentScope都能提供全方位的支持。

为什么选择AgentScope构建多智能体系统？

在现代AI应用开发中，多智能体架构已成为处理复杂任务的关键技术。与传统的单智能体系统相比，多智能体平台能够通过智能体间的协作与分工，显著提升系统的整体性能和鲁棒性。

AgentScope作为一款生产级别的多智能体框架，具有以下优势：

• 简单易用：5分钟即可开始构建智能体，内置ReAct智能体、工具、技能、人工介入控制、内存、规划、实时语音、评估和模型微调功能
• 高度可扩展：丰富的生态系统集成，支持工具、内存和可观测性；内置MCP和A2A支持；灵活的多智能体编排和工作流的消息中心
• 生产就绪：支持本地部署、云端无服务器部署或K8s集群部署，内置OTel支持

快速安装AgentScope的步骤

AgentScope要求Python 3.10或更高版本。以下是两种安装方式：

从PyPI安装

pip install agentscope

或使用uv：

uv pip install agentscope

从源码安装

# 从GitCode克隆源代码
git clone -b main https://gitcode.com/GitHub_Trending/ag/agentscope

# 进入项目目录
cd agentscope

# 以可编辑模式安装包
pip install -e .
# 或使用uv：
# uv pip install -e .

构建第一个多智能体应用

Hello AgentScope：简单的智能体对话

下面是一个简单的示例，展示如何创建一个名为"Friday"的ReAct智能体，并与用户进行对话：

from agentscope.agent import ReActAgent, UserAgent
from agentscope.model import DashScopeChatModel
from agentscope.formatter import DashScopeChatFormatter
from agentscope.memory import InMemoryMemory
from agentscope.tool import Toolkit, execute_python_code, execute_shell_command
import os, asyncio

async def main():
    toolkit = Toolkit()
    toolkit.register_tool_function(execute_python_code)
    toolkit.register_tool_function(execute_shell_command)

    agent = ReActAgent(
        name="Friday",
        sys_prompt="You're a helpful assistant named Friday.",
        model=DashScopeChatModel(
            model_name="qwen-max",
            api_key=os.environ["DASHSCOPE_API_KEY"],
            stream=True,
        ),
        memory=InMemoryMemory(),
        formatter=DashScopeChatFormatter(),
        toolkit=toolkit,
    )

    user = UserAgent(name="user")

    msg = None
    while True:
        msg = await agent(msg)
        msg = await user(msg)
        if msg.get_text_content() == "exit":
            break

asyncio.run(main())

实时语音智能体：打造语音交互系统

AgentScope支持创建具有语音功能的智能体，实现语音输入和输出。你可以构建一个实时语音聊天机器人，甚至可以实现多智能体语音交互的狼人游戏。

相关示例代码可在实时语音智能体和多智能体实时对话中找到。

多智能体工作流设计与实现

AgentScope提供了MsgHub和流水线功能，简化了多智能体对话的管理，提供高效的消息路由和无缝的信息共享。

多智能体对话管理

以下示例展示了如何创建一个消息中心来管理多智能体对话：

from agentscope.pipeline import MsgHub, sequential_pipeline
from agentscope.message import Msg
import asyncio

async def multi_agent_conversation():
    # 创建智能体
    agent1 = ...
    agent2 = ...
    agent3 = ...
    agent4 = ...

    # 创建消息中心来管理多智能体对话
    async with MsgHub(
        participants=[agent1, agent2, agent3],
        announcement=Msg("Host", "Introduce yourselves.", "assistant")
    ) as hub:
        # 按顺序发言
        await sequential_pipeline([agent1, agent2, agent3])
        # 动态管理参与者
        hub.add(agent4)
        hub.delete(agent3)
        await hub.broadcast(Msg("Host", "Goodbye!", "assistant"))

asyncio.run(multi_agent_conversation())

多智能体协作案例

AgentScope提供了多种多智能体工作流示例，包括：

• 多智能体辩论
• 多智能体对话
• 多智能体并发
• 多智能体实时对话

这些示例展示了如何设计和实现不同类型的多智能体协作模式，为构建复杂的分布式AI应用提供了参考。

高级功能：MCP与智能体技能

灵活的MCP使用

AgentScope支持MCP（多智能体通信协议），允许将MCP工具作为本地可调用函数使用，以组合工具包或包装成更复杂的工具。

from agentscope.mcp import HttpStatelessClient
from agentscope.tool import Toolkit
import os

async def fine_grained_mcp_control():
    # 初始化MCP客户端
    client = HttpStatelessClient(
        name="gaode_mcp",
        transport="streamable_http",
        url=f"https://mcp.amap.com/mcp?key={os.environ['GAODE_API_KEY']}",
    )

    # 获取MCP工具作为本地可调用函数，并在任何地方使用
    func = await client.get_callable_function(func_name="maps_geo")

    # 选项1：直接调用
    await func(address="Tiananmen Square", city="Beijing")

    # 选项2：作为工具传递给智能体
    toolkit = Toolkit()
    toolkit.register_tool_function(func)
    # ...

    # 选项3：包装成更复杂的工具
    # ...

智能体技能与评估

AgentScope支持Anthropic智能体技能，并提供了评估工具来衡量智能体性能。例如，ACEBench是一个用于评估智能体能力的基准测试工具。

相关实现可在ACEBench中找到。

部署与扩展：从原型到生产

AgentScope提供了多种部署选项，包括本地部署、云端无服务器部署和K8s集群部署。此外，还支持代码优先的部署方式，如规划智能体部署示例所示。

AgentScope Studio提供了可视化的开发和监控环境，帮助开发者更轻松地构建、测试和部署多智能体应用。

总结：构建强大的分布式AI应用

AgentScope为构建分布式多智能体AI应用提供了全面的解决方案。无论是简单的智能体对话还是复杂的多智能体协作系统，AgentScope都能提供所需的工具和组件。通过灵活的架构设计和丰富的功能集，AgentScope使开发者能够快速构建稳健、可扩展的智能体应用，并轻松部署到生产环境。

无论你是AI初学者还是经验丰富的开发者，AgentScope都能帮助你将多智能体应用的想法变为现实。立即开始探索AgentScope，构建属于你的分布式AI应用吧！

【免费下载链接】agentscope 项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope