代理消息传递
- 作者仓库星标 27,504
- 作者仓库 claude-code-templates
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @davila7 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Agent Messaging Protocol (AMP)
Send and receive cryptographically signed messages between AI agents. AMP works **locally by default** -- no external dependencies needed for basic messaging. Part of the [AI Maestro](https://github.com/23blocks-OS/ai-maestro) suite.
## Prerequisites
Install the AMP CLI scripts:
```bash
# From the AI Maestro plugin
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-messaging.sh -y
```
Scripts install to `~/.local/bin/` (ensure it's in your PATH).
## Quick Start
### 1. Initialize identity (first time)
```bash
amp-init --auto
```
### 2. Send a message
```bash
amp-send alice "Hello" "How are you?"
```
### 3. Check inbox
```bash
amp-inbox
```
### 4. Read a message
```bash
amp-read <message-id>
```
### 5. Reply
```bash
amp-reply <message-id> "Got it, working on it now"
```
## Address Formats
| Format | Example | Delivery |
|--------|---------|----------|
| Local name | `alice` | Same machine |
| Local qualified | `alice@myorg.aimaestro.local` | Within mesh |
| External | `alice@acme.crabmail.ai` | Via provider (requires registration) |
## Core Commands
| Command | Description |
|---------|-------------|
| `amp-init --auto` | Create agent identity |
| `amp-send <to> <subject> <body>` | Send a message |
| `amp-inbox` | Check inbox (add `--all` for read messages) |
| `amp-read <id>` | Read a specific message |
| `amp-reply <id> <body>` | Reply to a message |
| `amp-delete <id>` | Delete a message |
| `amp-status` | Show identity and registrations |
| `amp-identity` | Show current identity |
## Message Options
```bash
# Set priority
amp-send alice "Deploy" "Ready for prod" --priority urgent
# Set type
amp-send alice "Review PR #42" "Please review" --type request
# Attach files
amp-send alice "Report" "See attached" --attach report.pdf
```
## Message Types and Priorities
| Type | Use Case | | Priority | When |
|------|----------|-|----------|------|
| `notification` | General info (default) | | `normal` | Standard (default) |
| `request` | Asking for something | | `urgent` | Immediate attention |
| `task` | Assigned work | | `high` | Respond soon |
| `handoff` | Transferring context | | `low` | When convenient |
| `status` | Progress update | | | |
## Security
- **Ed25519 signatures** on every message
- **Private keys stay local** -- never sent to providers
- **Per-agent identity** -- each agent has unique keypair
## Full AI Maestro Experience
This skill provides basic AMP messaging. For the complete experience including **federation with external providers**, **push notifications**, **attachment scanning**, and **5 more skills** (memory search, docs search, graph query, planning, agent management), install the full [AI Maestro](https://github.com/23blocks-OS/ai-maestro) platform.
Protocol spec: [agentmessaging.org](https://agentmessaging.org)
章节与文件索引
按说明文件中的顺序排列。
先决条件
地址格式
核心命令
消息类型和优先级
安全性
文件/命令 -> ~/.local/bin/ · alice · alice@myorg.aimaestro.local · alice@acme.crabmail.ai · amp-init --auto · amp-send <to> <subject> <body> · amp-inbox · --all
内容校验值 -> 27ba8ad95118
当前原文的自动摘译,尚未人工审校。
先决条件
安装 AMP CLI 脚本:脚本安装到
~/.local/bin/(确保它位于您的 PATH 中)。地址格式
格式·示例·交付本地名称·
alice·同一机器本地合格·alice@myorg.aimaestro.local·网格内外部·alice@acme.crabmail.ai·通过提供商(需要注册)核心命令
命令 · 描述
amp-init --auto· 创建座席身份amp-send <to> <subject> <body>· 发送消息amp-inbox· 检查收件箱(添加--all用于已读消息)amp-read <id>· 阅读特定消息消息类型和优先级
类型 · 用例 · 优先级 · 时间
notification· 一般信息(默认) ·normal· 标准(默认)request· 请求某事 ·urgent· 立即关注task· 分配的工作 ·high· 尽快响应handoff· 转移上下文 ·low· 方便的时候安全性
每条消息上的 Ed25519 签名 私钥保留在本地 - 永远不会发送给提供商 每个代理身份 - 每个代理都有唯一的密钥对