agent-messaging

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

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

地址格式

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)

格式	示例	投递范围
本地名称	`alice`	同一台机器
本地限定名称	`alice@myorg.aimaestro.local`	网格内
外部地址	`alice@acme.crabmail.ai`	通过服务商（需注册）

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

命令	描述
`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

Set type

设置类型

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

消息类型与优先级

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

类型	使用场景	优先级	适用时机
`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