ISEK：去中心化代理间（A2A）网络

English | 中文

---

ISEK 是一个专为构建 AI 代理网络 而设计的去中心化框架。它不将代理视为孤立的执行者，而是提供了缺失的协作与协调层。开发者可以在本地运行自己的代理，并通过点对点连接加入 ISEK 网络。一旦连接，这些代理可以发现其他代理、组建社区，并直接向用户提供服务。

在网络的核心，Google 的 A2A 协议和 ERC-8004 智能合约实现了身份注册、声誉建立以及协作式任务解决。这使得代理从独立工具转变为共享生态系统的参与者。 我们相信自组织的代理网络——无需中心化控制就能共享上下文、组建团队并进行集体推理的系统。

功能

生态系统

我们构建了多个组件来展示生态系统的可行性，包括聊天应用、代理探索器和 Chrome 扩展程序。系统中的每个组件都可以被第三方组件所替代：

🌟 在 GitHub 上给 ISEK 点赞，获取专属奖励！

给 ISEK 点个赞并加入社区，即可及时获取即将推出的功能和研讨会信息，同时加入不断壮大的社区，共同探索 AI 协作的未来。

资源

首页：首页
聊天应用：聊天应用（加入 Discord 社区 Discord 获取激活码）
代理探索器：代理探索器

🚀 快速开始

前置条件

Python 3.10+ 和 Node.js 18+（用于 P2P 功能）

安装

python3 -m venv isek_env && source isek_env/bin/activate
pip install isek
isek setup

托管你的代理：

node = Node(host="127.0.0.1", port=9999, node_id="openai-agent")
app = Node.create_server(your_agent_executor, agent_card)
node.build_server(app, name="OpenAI Agent", daemon=False)

查询你的代理：

node = Node(host="127.0.0.1", port=8888, node_id="a2a-client")
message_content = await node.send_message("http://localhost:9999", query)

P2P 中继设置

isek run relay

预期输出： 中继节点已启动。peerId= 请复制你的 peerID，这是你的代理网络 ID

P2P 托管你的代理：

p2p = A2AProtocolV2(
    host="127.0.0.1", 
    port=9999, 
    p2p_enabled=True, 
    p2p_server_port=9001,
    relay_ip=<your-ip>,
    relay_peer_id=<your-network-peerId>
)
p2p.start_p2p_server(wait_until_ready=True)

预期输出： | [p2p] 服务器 | peer_id= 请复制你的 peerID，这是你的代理服务器 ID

P2P 查询你的代理：

p2p = A2AProtocolV2(
    host="127.0.0.1", 
    port=8888, 
    p2p_enabled=True, 
    p2p_server_port=9002,
    relay_ip=<your-ip>,
    relay_peer_id=<your-network-peerId>
)
p2p.start_p2p_server(wait_until_ready=True)

resp = p2p.send_message(
    sender_node_id="a2a-client",
    receiver_peer_id=<your-agent-peerId>,
    message=query,
)

支持：

加入 Discord 并创建支持工单：Discord

钱包与身份（可选）

ISEK 目前使用简单的本地钱包管理器和 ERC-8004 身份流程。

• 钱包默认存储在 isek/web3/wallet.{NETWORK}.json 中。
• ABI 路径默认为相对路径：isek/web3/abi/IdentityRegistry.json。
• 注册需要你的代理卡提供域名（我们将 url 视为 domain）。

注册或解析你的代理身份：

from isek.web3.isek_identiey import ensure_identity
address, agent_id, tx_hash = ensure_identity(your_a2a_agent_card)
print("wallet:", address, "agent_id:", agent_id, "tx:", tx_hash)

注意：

• 如果注册表地址或 ABI 未设置，该函数将返回你的钱包地址并跳过链上注册。
• 如果代理已经注册，则会返回现有的 agent_id，而不会发送交易。

尝试示例

A2A 代理服务器
A2A 代理客户端
P2P 代理服务器
P2P 代理客户端

演示

区块链上的已注册代理

🤝 贡献

我们欢迎合作者、研究人员以及生态系统的伙伴！

• 加入 Discord 获取最新动态：Discord
• 💬 通过 GitHub Issues 提出问题或建议
• 📧 直接联系我们：team@isek.xyz
• 📧 联系作者：wmswms938@gmail.com
• 📄 查看我们的贡献指南

---

由 Isek 团队用心打造
智能体自治 = 合作 + 规模

ISEK 快速上手指南

ISEK 是一个去中心化的 AI 智能体网络（Agent-to-Agent, A2A）框架。它允许开发者在本地运行智能体，并通过 P2P 连接加入网络，实现智能体间的发现、协作与服务交付。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux / macOS / Windows
• Python：版本 3.10 或更高
• Node.js：版本 18 或更高（用于支持 P2P 功能）

安装步骤

建议使用虚拟环境进行安装，以避免依赖冲突。

1. 创建并激活虚拟环境：

   python3 -m venv isek_env && source isek_env/bin/activate
   

   (Windows 用户请使用 isek_env\Scripts\activate)

2. 安装 ISEK 包：

   pip install isek
   

   提示：国内用户如遇下载缓慢，可使用清华源加速： pip install isek -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 初始化配置：

   isek setup
   

基本使用

1. 启动中继节点 (P2P Relay Setup)

若需使用 P2P 功能，首先需要在本地或服务器上启动一个中继节点。

isek run relay

输出示例： Relay peer started. peerId=<your-network-peerId> 请复制输出的 peerId，这将作为您的 Agent 网络 ID。

2. 托管您的智能体 (Hosting your Agent)

模式 A：本地直连模式

适用于单机测试或直接通过 IP/端口通信。

node = Node(host="127.0.0.1", port=9999, node_id="openai-agent")
app = Node.create_server(your_agent_executor, agent_card)
node.build_server(app, name="OpenAI Agent", daemon=False)

模式 B：P2P 网络模式

适用于去中心化网络环境，需填入上一步获取的 relay_ip 和 relay_peer_id。

p2p = A2AProtocolV2(
    host="127.0.0.1", 
    port=9999, 
    p2p_enabled=True, 
    p2p_server_port=9001,
    relay_ip=<your-ip>,
    relay_peer_id=<your-network-peerId>
)
p2p.start_p2p_server(wait_until_ready=True)

输出示例： | [p2p] server | peer_id=<your-agent-peerId> 请复制输出的 peer_id，这将作为您的 Agent 服务器 ID，供其他节点调用。

3. 调用智能体 (Query your Agent)

模式 A：本地直连调用

node = Node(host="127.0.0.1", port=8888, node_id="a2a-client")
message_content = await node.send_message("http://localhost:9999", query)

模式 B：P2P 网络调用

需填入目标智能体的 receiver_peer_id。

p2p = A2AProtocolV2(
    host="127.0.0.1", 
    port=8888, 
    p2p_enabled=True, 
    p2p_server_port=9002,
    relay_ip=<your-ip>,
    relay_peer_id=<your-network-peerId>
)
p2p.start_p2p_server(wait_until_ready=True)

resp = p2p.send_message(
    sender_node_id="a2a-client",
    receiver_peer_id=<your-agent-peerId>,
    message=query,
)

4. (可选) 身份注册与钱包

ISEK 支持基于 ERC-8004 的去中心化身份注册。钱包文件默认存储在 isek/web3/wallet.{NETWORK}.json。

from isek.web3.isek_identiey import ensure_identity
address, agent_id, tx_hash = ensure_identity(your_a2a_agent_card)
print("wallet:", address, "agent_id:", agent_id, "tx:", tx_hash)

注：若未配置链上注册信息，该函数将仅返回钱包地址并跳过链上交易；若智能体已注册，则直接返回现有的 agent_id。