agentmesh README

项目的 README,来自 github.com/google/agentmesh。合并为一个 markdown 文件:README.md。

Agent Mesh

Agent Mesh

Agent Mesh is a private network for AI agents. A node runs next to an agent and gives it three things: a way to publish tools and models to the network, a way to find and call what other nodes publish, and an identity every other node can verify. Nodes connect directly when they can and through relays when they cannot, so the network works across laptops, containers, clusters and phones behind NAT.

Note: We have updated the name to Agent Mesh to better align with the goals of the project in the ecosystem.

Two properties hold everywhere:

Try it

curl -sL https://google.github.io/agentmesh/install.sh | bash  # agentmesh-node, mcp-client and friends
agentmesh-node join https://bananas.sam-mesh.dev               # one-time login
agentmesh-node run --daemonize                                 # local MCP server on 127.0.0.1:8080
agentmesh-node skill install                                   # teach your agent to use it

Your agent now has tools that discover and call services across the mesh, and an OpenAI-compatible endpoint that routes model requests to whoever serves the model. bananas.sam-mesh.dev is a shared developer testnet with no uptime promise; the quick start walks through it, and your own mesh runs a control plane on your laptop in one command.

To run a control plane of your own without installing anything, open a GitHub codespace with the released binaries and run make testnet. It starts on a public https URL that your laptop and phone can enroll into, on your GitHub account's free quota:

Open in GitHub Codespaces

The Codespaces guide has the steps, what persists and what stops.

What is in a mesh

Program Role
agentmesh-control-plane Verifies who is joining, issues each node a signed credential, and holds the policy that says who may call what.
agentmesh-router A well-known peer that nodes connect to first. Relays traffic between nodes that cannot reach each other and hosts the discovery table.
agentmesh-node Runs next to your agent or service. Enrolls, connects, serves your local backends to the mesh, and exposes the mesh to your agent as a local MCP server and OpenAI-compatible API.
agentmesh-one The control plane, a router and a web console in one binary, for laptops and small deployments.

Documentation

google.github.io/agentmesh/docs is built from site/.

The repository has a dev container with the Go, Node and Python toolchains and Docker, so you can build and test in a codespace or in VS Code without installing anything:

Develop in GitHub Codespaces

Status

Agent Mesh is pre-1.0. The node, routers, control plane, identity and policy model are stable in shape and exercised by the test suite and two public testnets; see ROADMAP.md for the release plan. Sandboxed agent blueprints and the mobile app are in preview.

License and disclaimer

Apache-2.0; see LICENSE. This is not an officially supported Google product, and it is not eligible for the Google Open Source Software Vulnerability Rewards Program.

agentmesh (google/agentmesh)

正在搜索数据库…

这是什么?Agent Mesh 是一个面向 AI 智能体的私有网络。节点与智能体运行在一起,让智能体能够把工具和模型发布到网络上,发现并调用其他节点发布的内容,并向网络中的每个其他节点证明自己的身份。
这是一个二进制文件,还是几个独立的服务?它由四个程序组成:control-plane(负责验证节点并保存策略)、router(负责转发流量并提供发现服务)、node(与你的智能体运行在一起,提供本地 MCP 服务器和兼容 OpenAI 的 API),以及 agentmesh-one,它把 control plane、router 和 Web 控制台打包成一个二进制文件,适用于笔记本电脑和小型部署。
我该如何让它运行起来?按照快速入门指南加入位于 bananas.sam-mesh.dev 的共享开发测试网;或者在 GitHub Codespace 中使用已发布的二进制文件,运行 make testnet 来搭建你自己的控制平面。
加入 mesh 需要身份提供方吗?需要。节点可以使用来自你的身份提供方的 OpenID Connect 令牌注册,也可以使用引导令牌注册。控制平面会把引导令牌转换成短期有效、可离线验证的凭证。
这个项目可以用于生产环境吗?还不可以。Agent Mesh 目前处于 1.0 之前的阶段:节点、路由器、控制平面和策略模型在结构上已经稳定,并且已在两个公共测试网上经过测试;但沙箱智能体蓝图和移动应用仍处于预览阶段。
它只能在服务器上运行,还是笔记本电脑和手机也能加入?节点会在可能的情况下直接连接,否则回退到中继。因此,mesh 可以跨笔记本电脑、容器、集群以及位于 NAT 之后的手机使用。
默认情况下,mesh 会暴露什么?默认情况下,任何内容都无法被访问:除非进行配置,否则节点不会暴露任何服务;而且,除非 mesh 策略明确授权,否则任何节点都无法调用某个服务。授权是按服务名称而非网络地址来判定的。
我的智能体究竟是如何与 mesh 通信的?每个节点都会在本地向你的智能体提供 mesh 的访问入口,形式包括 MCP 服务器和兼容 OpenAI 的 API 端点。因此,你的智能体现有的工具调用或模型调用代码,就可以访问 mesh 中任何位置发布的服务和模型。
不搭建自己的基础设施,能先试用吗?可以。bananas.sam-mesh.dev 是一个共享的开发测试网,不提供正常运行时间保证。你只需按照快速入门指南,即可直接在该测试网中注册。
我能把它部署到 Kubernetes 或 Cloud Run 上,而不是我的笔记本电脑上吗?可以。文档中既包含以笔记本电脑为主的 agentmesh-one 安装指南,也包含 Kubernetes 和 Cloud Run 部署指南。
a2a-protocol 标签对这个项目意味着什么?Agent Mesh 构建的网络中,节点可以在可验证身份和明确授权策略的约束下,发现并调用彼此发布的工具和模型。这正是本项目所实现的智能体间通信(agent-to-agent,A2A)模型。
有哪些类似的项目?casdoor, netmaker, hydra, archestra, oauth2-proxy, kratos, dex, bifrost
作者
google
大小
84.9 MB
星标
1.2K
时长
6个月
提交 · 90 天