designing-multiagent-systems

环境要求

• Python 环境（README 未标注最低版本，建议 3.10+）
• pip（用于执行 pip install -e . 安装包）
• 本地项目源码（通过 git clone 或下载 ZIP 获取）
• 至少一个 LLM 提供商的 API 凭证（OpenAI / Anthropic / Azure OpenAI / GitHub Models）

安装与启动步骤

1. 1获取项目代码

   从 GitHub 仓库拉取代码到本地，后续所有安装命令都要在项目根目录执行。

   git clone https://github.com/victordibia/designing-multiagent-systems.git
   cd designing-multiagent-systems

   复制

2. 2基础安装

   以可编辑模式安装 PicoAgents 包本体，默认不包含任何可选功能模块。

   pip install -e .

   复制

3. 3按需安装扩展

   按使用场景选择：web 提供 UI 与 API 服务，examples 用于跑示例脚本，也可直接装 all。

   pip install -e ".[web]"
   pip install -e ".[examples]"
   pip install -e ".[all]"

   复制

4. 4配置 API 密钥

   设置所选用模型提供商的密钥为环境变量，未设置则智能体无法调用模型。

   export OPENAI_API_KEY="sk-xxxxxxxx"

   复制

5. 5运行示例验证

   仓库示例脚本位于根目录的 examples/agents/ 下，先跑基础 agent 示例确认环境可用。

   python examples/agents/basic-agent.py

   复制

关键配置

如何确认成功

能成功 import picoagents 并运行基础示例脚本且无报错，即表示安装与环境变量配置正确。

常见问题

注意事项

• 本仓库是书籍《Designing Multi-Agent Systems》的配套代码，结合书中内容学习效果更好。
• README 中“Run Examples”一节的命令未完整给出，示例脚本路径来自文档表格中的引用，请以仓库实际文件为准。
• Windows 环境设置密钥时需改用 set 或 PowerShell 的 $env:OPENAI_API_KEY="sk-xxxxxxxx"。
• 可编辑安装（-e）后修改源码立即生效，便于跟随教程逐步实现各组件。