Back to Details

agent-messaging

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Messaging Protocol (AMP)

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 suite.
在AI Agent之间发送和接收经过加密签名的消息。AMP默认本地运行——基础消息功能无需外部依赖。属于AI Maestro套件的一部分。

Prerequisites

前置条件

Install the AMP CLI scripts:
bash
undefined
安装AMP CLI脚本：
bash
undefined

From the AI Maestro plugin

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).
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git cd ai-maestro-plugins && ./install-messaging.sh -y

脚本将安装到`~/.local/bin/`（请确保该路径已添加到你的PATH中）。

Quick Start

快速开始

1. Initialize identity (first time)

1. 初始化身份（首次使用）

bash
amp-init --auto
bash
amp-init --auto

2. Send a message

2. 发送消息

bash
amp-send alice "Hello" "How are you?"
bash
amp-send alice "Hello" "How are you?"

3. Check inbox

3. 查看收件箱

bash
amp-inbox
bash
amp-inbox

4. Read a message

4. 读取消息

bash
amp-read <message-id>
bash
amp-read <message-id>

5. Reply

5. 回复消息

bash
amp-reply <message-id> "Got it, working on it now"
bash
amp-reply <message-id> "Got it, working on it now"

Address Formats

地址格式

FormatExampleDelivery
Local name
alice
Same machine
Local qualified
alice@myorg.aimaestro.local
Within mesh
External
alice@acme.crabmail.ai
Via provider (requires registration)
格式示例投递范围
本地名称
alice
同一台机器
本地限定名称
alice@myorg.aimaestro.local
网格内
外部地址
alice@acme.crabmail.ai
通过服务商（需注册）

Core Commands

核心命令

CommandDescription
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
命令描述
amp-init --auto
创建Agent身份
amp-send <to> <subject> <body>
发送消息
amp-inbox
查看收件箱（添加
--all
可查看已读消息）
amp-read <id>
读取指定消息
amp-reply <id> <body>
回复消息
amp-delete <id>
删除消息
amp-status
显示身份与注册信息
amp-identity
显示当前身份

Message Options

消息选项

bash
undefined
bash
undefined

Set priority

设置优先级

amp-send alice "Deploy" "Ready for prod" --priority urgent
amp-send alice "Deploy" "Ready for prod" --priority urgent

Set type

设置类型

amp-send alice "Review PR #42" "Please review" --type request
amp-send alice "Review PR #42" "Please review" --type request

Attach files

附加文件

amp-send alice "Report" "See attached" --attach report.pdf
undefined
amp-send alice "Report" "See attached" --attach report.pdf
undefined

Message Types and Priorities

消息类型与优先级

TypeUse CasePriorityWhen
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
类型使用场景优先级适用时机
notification
通用信息（默认）
normal
标准场景（默认）
request
请求协助
urgent
需要立即关注
task
分配工作任务
high
需尽快响应
handoff
转移上下文
low
方便时处理
status
进度更新

Security

安全性

  • Ed25519 signatures on every message
  • Private keys stay local -- never sent to providers
  • Per-agent identity -- each agent has unique keypair
  • 每条消息均带有Ed25519签名
  • 私钥本地存储——绝不会发送给服务商
  • Agent独立身份——每个Agent都有唯一的密钥对

Full AI Maestro Experience

完整AI Maestro体验

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 platform.
Protocol spec: agentmessaging.org
本技能提供基础的AMP消息功能。若要获得完整体验，包括与外部服务商的联邦互通、推送通知、附件扫描以及另外5项技能（内存搜索、文档搜索、图查询、任务规划、Agent管理），请安装完整的AI Maestro平台。
协议规范：agentmessaging.org