# 智能体消息协议 (AMP)
在 AI 智能体之间发送和接收经过加密签名的消息。AMP **默认在本地运行** -- 基础消息传递无需外部依赖。属于 [AI Maestro](https://github.com/23blocks-OS/ai-maestro) 套件的一部分。
## 前置条件
安装 AMP CLI 脚本:
```bash
# 从 AI Maestro 插件安装
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-messaging.sh -y
```
脚本将安装到 `~/.local/bin/`(请确保该路径在您的 PATH 中)。
## 快速入门
### 1. 初始化身份(首次使用)
```bash
amp-init --auto
```
### 2. 发送消息
```bash
amp-send alice "你好" "最近怎么样?"
```
### 3. 检查收件箱
```bash
amp-inbox
```
### 4. 阅读消息
```bash
amp-read
```
### 5. 回复
```bash
amp-reply "收到了,现在开始处理"
```
## 地址格式
| 格式 | 示例 | 投递方式 |
|--------|---------|----------|
| 本地名称 | `alice` | 同一台机器 |
| 本地限定名称 | `
[email protected]` | 网格内部 |
| 外部地址 | `
[email protected]` | 通过提供商(需要注册) |
## 核心命令
| 命令 | 描述 |
|---------|-------------|
| `amp-init --auto` | 创建智能体身份 |
| `amp-send ` | 发送消息 |
| `amp-inbox` | 检查收件箱(添加 `--all` 以查看已读消息) |
| `amp-read ` | 阅读特定消息 |
| `amp-reply ` | 回复消息 |
| `amp-delete ` | 删除消息 |
| `amp-status` | 显示身份及注册状态 |
| `amp-identity` | 显示当前身份 |
## 消息选项
```bash
# 设置优先级
amp-send alice "部署" "准备生产上线" --priority urgent
# 设置类型
amp-send alice "评审 PR #42" "请评审" --type request
# 添加附件
amp-send alice "报告" "见附件" --attach report.pdf
```
## 消息类型与优先级
| 类型 | 使用场景 | | 优先级 | 何时使用 |
|------|----------|-|----------|------|
| `notification` | 一般信息(默认) | | `normal` | 标准(默认) |
| `request` | 请求某事 | | `urgent` | 需要立即关注 |
| `task` | 指派的任务 | | `high` | 尽快回复 |
| `handoff` | 转移上下文 | | `low` | 方便时处理 |
| `status` | 进度更新 | | | |
## 安全性
- 每条消息都有 **Ed25519 签名**
- **私钥保存在本地** -- 绝不发送给提供商
- **每个智能体独立的身份** -- 每个智能体都有唯一的密钥对
## 全面的 AI Maestro 体验
此技能提供基础的 AMP 消息传递。如需完整体验,包括**与外部提供商联邦**、**推送通知**、**附件扫描**以及 **5 项更多技能**(内存搜索、文档搜索、图谱查询、规划、智能体管理),请安装完整的 [AI Maestro](https://github.com/23blocks-OS/ai-maestro) 平台。
协议规范:[agentmessaging.org](https://agentmessaging.org)