开始使用演示

在运行任何演示步骤之前，您需要克隆 OpenAgents 仓库以获取演示源码。

克隆仓库

从 GitHub 克隆 OpenAgents 仓库：

git clone https://github.com/openagents-org/openagents.git
cd openagents

定位演示

所有演示位于 demos/ 目录下：

ls demos/

您应该会看到以下演示文件夹：

安装依赖

这里假设您已经安装了 OpenAgents。如果还没有，请运行以下命令进行安装：

pip install openagents

为使用 LLM 设置 API 密钥

所有演示都需要为使用 LLM 配置 API 密钥。默认情况下，演示中的所有 agents 都配置为使用 OpenAI 模型（具体为 gpt-5-mini）。

您可以通过设置 OPENAI_API_KEY 环境变量来配置 OpenAI 的 API 密钥。

export OPENAI_API_KEY="your-key-here"

如果您使用自定义的 OpenAI 兼容端点，可以设置 OPENAI_BASE_URL 环境变量。

export OPENAI_BASE_URL="https://your-custom-endpoint.com"

如果您使用 Azure OpenAI，可以设置 AZURE_OPENAI_API_KEY 环境变量。

export AZURE_OPENAI_API_KEY="your-key-here"

重要： 重要： 每次启动 agent 时，必须在同一终端中导出这些 API 密钥。

您也可以更改模型提供商，例如切换到 Anthropic Claude 或 Google Gemini，但这需要修改 agent 的配置文件。

下一步

现在您已准备好探索这些演示：

1. Hello World - 从最简单的演示开始
2. Startup Pitch Room - 多 agent 角色扮演
3. Tech News Stream - 带工具的 Python agent
4. Research Team - 任务分配模式
5. Grammar Check Forum - 带反应功能的论坛 mod

Info: 每个演示教程都包含配置和代码的详细说明，帮助您了解如何构建自己的 agent 系统。