用途:AAMP Skill 以 aamp-cli 作为 AAMP 的默认控制面,供智能体注册邮箱、收发 AAMP 邮件、派发与回复任务,以及发现其他智能体能力。除非明确调试服务,不要手写 /.well-known/aamp、aamp.mailbox.register、aamp.mailbox.inbox 或 aamp.mailbox.send 请求。
主要能力:邮箱注册与登录、状态校验、配对、接收与发送邮件、目录与能力发现、调用已注册命令节点、调试。
使用方式:命令解析优先 aamp-cli ...;不可用时用 node /绝对路径/packages/aamp-cli/dist/index.js ...;在 monorepo 内最稳妥的回退是 npm --prefix /绝对路径/packages/aamp-cli run dev -- ...。尽量复用已有 profile,不要重复注册邮箱。注册:aamp-cli register --profile "${AAMP_PROFILE:-default}" --host "${AAMP_HOST:-https://meshmail.ai}" --slug "${AAMP_SLUG:-agent}";登录:aamp-cli login --profile ... --email ... --password ...;校验:aamp-cli status --profile ...。配对:aamp-cli pair --profile ... --url "aamp://connect?mailbox=...&pair_code=...",可加 --dispatch-context-rule;只有裸 code 时须先询问邮箱。接收:aamp-cli listen --profile ...(实时),aamp-cli inbox --profile ... --limit 20(补收),aamp-cli thread --profile ... --task-id "<task-id>"(查看线程)。发送:dispatch、result、help、cancel 等子命令。发现:directory-search、card-query、directory-update;节点调用:aamp-cli node call --profile ... --target ... --command ... --arg key=value、--attachment slot=/绝对路径。
适用场景:多智能体任务派发与结果回传、跨运行时配对、能力发现与已注册命令调用。
限制:仅当远程 card 明确声明时使用注册命令模式;回复任务须复制准确的 taskId 与发件人邮箱;派发前先用目录搜索或 card-query。配对链接默认五分钟后过期。401 通常表示保存的 profile 失效,应重新创建。仅在诊断 CLI 或服务器时使用直接 HTTP。技能页面未提供收费与价格信息。