diff --git a/README_CN.md b/README_CN.md index 0b0d22c..67c6019 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,15 +1,21 @@ -

- Isek Banner + ISEK Banner

-

Isek：去中心化的 Agent-to-Agent (A2A) 网络

+

ISEK: 去中心化 Agent-to-Agent (A2A) 网络

PyPI 版本 - 许可证：MIT + 许可证: MIT 邮箱 + Python 版本 + 测试 + 教程 + 文档 + 示例 + Discord + Twitter

@@ -18,133 +24,151 @@

--- +**ISEK** 是一个专为构建 **AI Agent 网络**而设计的去中心化框架。它不是将 Agent 视为孤立的执行器,而是提供了缺失的协作和协调层。开发者在本地运行他们的 Agent,通过点对点连接,这些 Agent 加入 ISEK 网络。一旦连接,它们就可以发现其他 Agent、组建社区,并直接向用户提供服务。 -**Isek** 是一个去中心化的Agent网络框架，旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 去中心化网络。Isek 中的Agent能够自主发现其他网络节点、共享上下文并协同解决复杂任务，形成一个自组织的去中心化智能体社区。 - -Isek 通过高度集成主流大语言模型（LLM）以及Agent通讯协议，帮助开发者和用户快速开发、部署并管理自己的智能体网络。 - -> 🧪 **ISEK 正在持续完善中。** 欢迎大家贡献代码、参与试用并反馈建议。 - ---- - -## 🌟 功能亮点 +在网络的核心,Google 的 A2A 协议和 ERC-8004 智能合约实现了身份注册、声誉构建和协作任务解决。这将 Agent 从独立工具转变为共享生态系统的参与者。 +我们相信自组织的 Agent 网络——能够共享上下文、组建团队并在没有中央控制的情况下进行集体推理的系统。 -- **🧠 去中心化协作：** - Agent 能自动发现伙伴协作，自组织控制，运行更可靠。 +## 功能特性 +

+ 功能特性 +

-- **🌐 分布式部署：** - 无缝支持多节点云端部署，具备可扩展性和高可用性。 -- **🗣️ LLM 增强智能：** - 开箱即用支持多个主流大模型，轻松实现智能对话与推理功能。 +## 生态系统 +我们构建了多个组件来展示生态系统的可行性,包括聊天应用、Agent 浏览器和 Chrome 扩展。系统的每个组件都可以被第三方组件替换: +

+ ISEK 生态系统概览 +

-- **🔌 模块化与可扩展：** - 可轻松自定义Agent、集成新模型或扩展功能。 -- **💻 开发者友好 CLI：** - 简洁命令行界面，轻松配置与控制Agent。 +## 🌟 在 GitHub 上为我们加星并获得专属奖励! +为 ISEK 加星并加入社区,获取即将推出的功能通知、工作坊信息,并加入我们不断发展的社区,共同探索 AI 协作的未来。 +Discord +

+ ISEK 生态系统概览 +

---- +## 资源 +主页: [主页](https://www.isek.xyz/)\ +聊天应用: [聊天应用](https://chatbot.isek.xyz/) (在 [Discord](https://C.gg/PRzG3MSP) 加入 Discord 社区获取激活码)\ +Agent 浏览器: [Agent 浏览器](https://isek-explorer.vercel.app/) +## 🚀 快速开始 -## 📦 安装方式 +### 前置要求 +**Python 3.10+** 和 **Node.js 18+** (用于 P2P 功能) +### 安装 ```bash +python3 -m venv isek_env && source isek_env/bin/activate pip install isek +isek setup ``` -> 依赖 **Python 3.10+** - ---- - -## 🚀 快速开始 - -### 1️⃣ 设置环境变量 +### 托管你的 Agent: +```python +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) +``` -创建 `.env` 文件： +### 查询你的 Agent: +```python +node = Node(host="127.0.0.1", port=8888, node_id="a2a-client") +message_content = await node.send_message("http://localhost:9999", query) +``` -```env -OPENAI_MODEL_NAME=gpt-4o-mini -OPENAI_BASE_URL=https://api.openai.com/v1 -OPENAI_API_KEY=your_api_key +### P2P 中继设置 +```bash +isek run relay ``` +预期输出: +中继节点已启动。peerId= +复制你的 peerID,这是你的 Agent 网络 ID -### 2️⃣ 启动Agent +### P2P 托管你的 Agent: ```python -from isek.agent.isek_agent import IsekAgent -from isek.models.openai import OpenAIModel -import dotenv -dotenv.load_dotenv() - -agent = IsekAgent( - name="My Agent", - model=OpenAIModel(model_id="gpt-4o-mini"), - description="A helpful assistant", - instructions=["Be polite", "Provide accurate information"], - success_criteria="User gets a helpful response" +p2p = A2AProtocolV2( + host="127.0.0.1", + port=9999, + p2p_enabled=True, + p2p_server_port=9001, + relay_ip=, + relay_peer_id= ) - -response = agent.run("hello") +p2p.start_p2p_server(wait_until_ready=True) ``` ---- +预期输出: +| [p2p] server | peer_id= +复制你的 peerID,这是你的 Agent 服务器 ID -## 🧪 CLI 命令 +### P2P 查询你的 Agent: -```bash -isek clean # 清理临时文件 -isek setup # 安装依赖 -isek --help # 查看可用命令 +```python +p2p = A2AProtocolV2( + host="127.0.0.1", + port=8888, + p2p_enabled=True, + p2p_server_port=9002, + relay_ip=, + relay_peer_id= +) +p2p.start_p2p_server(wait_until_ready=True) + +resp = p2p.send_message( + sender_node_id="a2a-client", + receiver_peer_id=, + message=query, +) ``` ---- +## 支持: +加入 Discord 并创建支持工单:[Discord](https://C.gg/PRzG3MSP) +Discord +### 钱包和身份 (可选) -## 🧱 项目结构 +ISEK 现在使用简单的本地钱包管理器和 ERC-8004 身份流程。 +- 钱包默认存储在 `isek/web3/wallet.{NETWORK}.json`。 +- ABI 路径默认为相对路径: `isek/web3/abi/IdentityRegistry.json`。 +- 注册需要你的 Agent 卡提供一个域名(我们将 `url` 视为 `domain`)。 +### 注册或解析你的 Agent 身份: +```python +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) ``` -isek/ -├── examples # Isek 使用示例脚本 -├── isek # 核心功能模块 -│ ├── agent # Agent 的逻辑与行为定义 -│ ├── node # 节点发现与网络编排 -│ ├── protocol # Agent 间通信的协议层 -│ ├── memory # Agent 的上下文与状态管理 -│ ├── models # LLM 后端模型接口 -│ ├── team # 多 Agent 协作与组织结构 -│ ├── tools # Agent 可调用的function工具库 -│ ├── utils # 通用工具函数 -│ ├── cli.py # 命令行入口 -│ └── isek_center.py # 本地注册中心与协调服务 -├── script # 辅助脚本（如清理工具） -├── pyproject.toml # 构建配置与依赖声明 -└── README.md # 项目简介与文档入口 -``` - ---- +注意事项: +- 如果未设置注册表地址或 ABI,该函数将返回你的钱包地址并跳过链上注册。 +- 如果 Agent 已经注册,它将返回现有的 `agent_id` 而不发送交易。 -## 🤝 贡献方式 +### 试用示例 -我们欢迎开发者、研究人员和早期使用者的加入！ +[A2A Agent 服务器](https://github.com/isekOS/ISEK/blob/main/examples/Agent_servers/Pydantic/openai_agent_a2a.py)\ +[A2A Agent 客户端](https://github.com/isekOS/ISEK/blob/main/examples/Agent_client/a2a_client.py)\ +[P2P Agent 服务器](https://github.com/isekOS/ISEK/blob/main/examples/Agent_servers/Pydantic/openai_agent_a2a_p2p.py)\ +[P2P Agent 客户端](https://github.com/isekOS/ISEK/blob/main/examples/Agent_client/a2a_client_p2p.py) -- 💬 通过 [GitHub Issues](https://github.com/your-repo/issues) 提出建议或反馈问题 -- 📧 联系我们：[team@isek.xyz](mailto:team@isek.xyz) -- 📄 查阅我们的 [贡献指南](CONTRIBUTING.md)，了解如何参与贡献 ---- +## 演示 +### 在区块链上注册的 Agent +

+ ISEK 生态系统概览 +

-## 📜 开源协议 +## 🤝 贡献 -本项目采用 [MIT License](LICENSE) 开源。 +我们欢迎开发者、研究人员和生态系统合作者! +* 加入 Discord 获取最新更新: [Discord](https://C.gg/PRzG3MSP) +* 💬 通过 [GitHub Issues](https://github.com/your-repo/issues) 提交问题或建议 +* 📧 直接联系我们: [team@isek.xyz](mailto:team@isek.xyz) +* 📄 查看我们的 [贡献指南](CONTRIBUTING.md) --- -## ⚠️ 法律声明 -ISEK 是一个开源、无许可的技术框架，旨在支持去中心化智能体协作系统的构建。 -本项目的贡献者不运营、控制或监控任何已部署的智能体或其行为。 -使用本项目即表示您将为自己的行为承担全部责任。详情请参阅 [LEGAL.md](./LEGAL.md)。 - ----

Made with ❤️ by the Isek Team
- Autonomy is not isolation. It's cooperation, at scale. + Agent Autonomy = Cooperation + Scale