浏览一系列实际示例，了解 AIGNE 框架的各种功能和工作流模式。本节提供可动手执行的演示，帮助您理解智能对话、MCP 协议集成、记忆机制以及复杂的 Agent 工作流。
快速入门
您可以使用 npx 直接运行任何示例，无需本地安装。这是体验 AIGNE 框架最快的方法。
前提条件
- 已安装 Node.js（版本 20.0 或更高）和 npm。
- 您所选的大语言模型（LLM）提供商的 API 密钥（例如 OpenAI）。
运行示例
在您的终端中执行以下命令来运行一个基本的聊天机器人。
- 设置您的 API 密钥： 将
YOUR_OPENAI_API_KEY替换为您的实际 OpenAI API 密钥。sh export OPENAI_API_KEY=YOUR_OPENAI_API_KEY - 以单次模式运行： Agent 将处理一个默认提示并退出。
sh npx -y @aigne/example-chat-bot - 以交互模式运行： 使用
--interactive标志启动一个交互式会话，您可以与 Agent 进行对话。sh npx -y @aigne/example-chat-bot --interactive
使用不同的 LLM
您可以通过设置 MODEL 环境变量以及相应的 API 密钥来指定不同的模型。以下是几个流行提供商的配置。
| 提供商 | 环境变量 |
|---|---|
| OpenAI | export MODEL=openai:gpt-4o export OPENAI_API_KEY=... |
| Anthropic | export MODEL=anthropic:claude-3-opus-20240229 export ANTHROPIC_API_KEY=... |
| Google Gemini | export MODEL=gemini:gemini-1.5-flash export GEMINI_API_KEY=... |
| DeepSeek | export MODEL=deepseek/deepseek-chat export DEEPSEEK_API_KEY=... |
| AWS Bedrock | export MODEL=bedrock:anthropic.claude-3-sonnet-20240229-v1:0 export AWS_ACCESS_KEY_ID=... export AWS_SECRET_ACCESS_KEY=... export AWS_REGION=... |
| Ollama | export MODEL=llama3 export OLLAMA_DEFAULT_BASE_URL="http://localhost:11434/v1" |
示例库
本节提供了一系列精选示例，每个示例都展示了 AIGNE 框架中的特定功能或工作流模式。点击任意卡片即可跳转至该示例的详细指南。
核心功能
聊天机器人
构建一个支持单次和交互模式的基础对话 Agent。
AFS 本地文件系统
创建一个可以在本地文件系统上读取、写入和列出文件的聊天机器人。
记忆
使用 FSMemory 插件实现一个具有持久记忆的 Agent。
Nano Banana
演示如何创建一个具备图像生成能力的聊天机器人。
工作流模式
顺序执行
按特定顺序执行一系列 Agent，如同流水线作业。
并发执行
同时运行多个 Agent 以并行执行任务，提高效率。
路由器
创建一个管理者 Agent，智能地将任务分配给相应的专业 Agent。
交接
实现无缝过渡，一个 Agent 将其输出传递给另一个 Agent 进行后续处理。
反思
构建能够审查和完善自身输出的 Agent，以实现自我修正和改进。
编排
协调多个 Agent 解决需要协作的复杂问题。
群聊
模拟多 Agent 讨论，Agent 之间可以互动并基于彼此的消息进行构建。
代码执行
在 AI 驱动的工作流中安全地执行动态生成的代码。
MCP 与集成
MCP 服务器
将 AIGNE Agent 作为模型上下文协议（MCP）服务器运行，以暴露其技能。
MCP Blocklet
与 Blocklet 集成，并将其功能作为 MCP 技能暴露。
MCP GitHub
通过连接到 GitHub MCP 服务器的 Agent 与 GitHub 仓库进行交互。
MCP Puppeteer
利用 Puppeteer 进行自动化网页抓取和浏览器交互。
MCP SQLite
连接到 SQLite 数据库以执行智能数据库操作。
DID Spaces 记忆
使用去中心化身份和存储（DID Spaces）持久化 Agent 的记忆。
调试
要深入了解 Agent 的执行情况，您可以启用调试日志或使用 AIGNE 观测服务器。
查看调试日志
将 DEBUG 环境变量设置为 * 以输出详细日志，其中包括模型调用和响应。
DEBUG=* npx -y @aigne/example-chat-bot --interactive使用观测服务器
aigne observe 命令会启动一个本地 Web 服务器，提供一个用户友好的界面来检查执行跟踪、查看详细的调用信息并了解您的 Agent 的行为。这是调试和性能调优的强大工具。
- 安装 AIGNE CLI：
sh npm install -g @aigne/cli - 启动观测服务器：
sh aigne observe
- 查看跟踪记录： 运行 Agent 后，在浏览器中打开
http://localhost:7893，即可查看最近的执行列表并检查每次运行的详细信息。