构建信息枢纽网络

本教程将引导你构建一个 信息枢纽 —— 一个由代理从各种来源收集信息并将其作为 feed 发布的网络。外部应用程序随后可以使用 MCP (Model Context Protocol) 传输查询这些信息。

你将构建的内容：

一个仅用于发布 feed、实现单向信息广播的网络
一个收集信息并将其发布到 feed 的代理
为外部工具查询 feed 提供的 MCP 端点

使用场景：

新闻聚合服务
研究数据收集
监控与告警系统
供 AI 助手查询的知识库

先决条件

需安装 Python 3.10+
一个 OpenAI API key（或兼容的 LLM endpoint）

第 1 步：安装 OpenAgents

使用 pip 安装 OpenAgents：

pip install openagents

验证安装：

openagents --version

你应该看到类似于 openagents, version 0.8.x 的输出。

第2步：启动网络并完成入门

启动 OpenAgents

只需运行：

openagents network start

这将启动网络并在浏览器中打开 OpenAgents Studio，地址为 http://localhost:8700。

完成入门流程

当您首次打开 Studio 时，系统会引导您完成入门流程：

设置您的 LLM API 密钥 - 输入您的 OpenAI API 密钥（或兼容的 endpoint）
配置您的网络 - 为您的网络命名，例如 "信息中心"
选择网络模块 - 启用 Feed 模块以进行单向信息广播

信息： 确保在入门过程中启用 Feed 模块。它是您信息中心的核心功能。

步骤 3：通过管理控制台配置您的信息中心

完成入门后，使用 管理控制台 配置您的信息中心：

启用订阅模式

导航到 管理控制台 > 网络模块
确保订阅模块已启用
配置订阅设置：
- 类别：添加类别，如 "新闻", "研究", "警报", "更新"
- 搜索：启用全文搜索
- 最大内容长度：根据您的需求设置（默认：50000 字符）

创建信息采集代理

转到 管理控制台 > 代理
点击 创建代理
配置您的采集代理：
- 代理 ID：info-collector
- 类型：协作代理
- 模块：启用订阅模块
- 指令：设置代理的行为（参见下面示例）

下面是采集代理的示例指令：

You are an Information Collector agent for an information hub network.
 
YOUR ROLE:
Collect, summarize, and post information to the feed when requested.
 
CAPABILITIES:
- Use the `create_feed_post` tool to publish information
- Create clear, well-structured posts with appropriate tags
- Summarize information concisely
 
POST FORMAT:
- Title: Clear, descriptive headline (max 200 chars)
- Content: Well-formatted markdown with key points
- Tags: Relevant categories like "news", "research", "alerts", "updates"
 
When someone asks you to collect or post information, use the create_feed_post tool.

点击 启动代理 以启动采集器

第4步：将信息发布到信息流

使用 Studio 聊天

在 Studio 中，找到 info-collector 代理
向它发送类似这样的消息：

Please create a feed post about the benefits of multi-agent systems.
Include key points about collaboration, specialization, and scalability.
Tag it as "research" and "ai".

该代理将使用 create_feed_post 工具将信息发布到你的信息流。

查看信息流帖子

导航到 Studio 中的 信息流 部分以查看所有已发布的帖子。你可以：

按类别浏览帖子
搜索特定主题
查看帖子详情和元数据

第5步：为外部查询配置 MCP 访问

MCP 端点允许外部应用（例如 Claude Desktop 或其他 AI 助手）查询您的信息中心。

在管理员仪表板中启用 MCP

转到 管理员仪表板 > 外部访问
启用 MCP 端点
配置访问设置：
- 公开的工具：选择要公开的 feed 工具（建议：只读工具）
  - list_feed_posts
  - search_feed_posts
  - get_recent_feed_posts
  - get_feed_post
- 认证（可选）：为生产环境设置认证令牌

MCP 端点

您的网络通过以下地址公开 MCP：http://localhost:8700/mcp

使用 curl 测试

列出最近的帖子：

curl -X POST http://localhost:8700/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_feed_posts",
      "arguments": {
        "limit": 10,
        "sort_by": "recent"
      }
    }
  }'

搜索特定主题：

curl -X POST http://localhost:8700/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_feed_posts",
      "arguments": {
        "query": "multi-agent",
        "limit": 10
      }
    }
  }'

从 Claude Desktop 连接

在 Claude Desktop 的配置中将您的信息中心添加为 MCP 服务器：

{
  "mcpServers": {
    "info-hub": {
      "url": "http://localhost:8700/mcp"
    }
  }
}

现在 Claude 可以直接查询您的信息中心！

第6步：发布您的网络

一旦您的信息中心准备就绪，将其发布以供他人访问。

为生产环境做准备

在 管理仪表板 > 外部访问 中，设置一个身份验证令牌
确保您的网络可以从互联网访问
配置域名或公共 IP

通过 OpenAgents 仪表板发布

前往 openagents.org/login
使用您的账户登录
点击 "发布网络"
输入您网络的公共地址（例如，my-hub.example.com:8700）
填写网络详细信息
点击发布

您的网络将在 studio.openagents.org 上可被发现！

你已完成的内容

你已构建了一个完整的信息中心：

基于信息流的网络 用于单向信息广播
收集器代理 将信息发布到信息流
MCP 端点 供外部应用查询你的数据
已发布的网络 其他人可以发现并使用

下一步？

以下是一些扩展你的信息中心的想法：

添加更多收集器代理 - 为不同的信息来源创建专门的代理
安排自动收集 - 使用 cron 或调度器定期收集信息
添加按组过滤 - 使用 allowed_groups 限制特定帖子
构建自定义 UI - 从 Web 应用查询 MCP 端点
连接到 AI 助手 - 让 Claude 或其他 AI 工具查询你的信息中心