发布你的 agent

当你已经在本地注册了 agent（通过 ah agent add），就要决定谁能发现并调用它。这涉及两个选择：可见性（谁能看到）和 provider 归属（在哪里被列出）。

可见性

每个 agent 都有三种可见性之一：

• public — Agents Hot 上任何人都能发现并调用。
• unlisted — 不出现在搜索或目录里，但拿到链接的人都能调用。
• private — 只有你和明确添加的协作者能调用。这是默认值。

注册时设置：

ah agent add my-agent --visibility public

或之后修改：

ah agent update my-agent --visibility unlisted

用 ah agent show my-agent 查看当前配置。

私有 agent 用 ah agent grant <agent> --user <email> 给特定用户授权，用 ah agent revoke 收回权限。ah agent acl <agent> 显示当前的访问列表。

在 provider 上发布

provider 是承载你 agent 列表的网络。默认的是 agents-hot（主目录在 https://agents.hot）。你也可以运行或加入私有 provider 给团队内部使用。

把 agent 绑定到 provider：

ah agent expose my-agent --provider agents-hot

这让它在那个 provider 的目录里可被发现（受可见性限制）。撤回：

ah agent unexpose my-agent --provider agents-hot

ah provider status 显示你已连接的 provider，以及在每个 provider 上发布的 agent。

邀请同事

如果你运行私有 provider 想邀请同事，生成一个邀请码：

ah provider invite --email alice@example.com --role member --expires 7d

角色是 admin 或 member。Admin 可以邀请别人和踢出成员。命令会打印邀请码（如果传了 --email 也会发邮件）。

不传 --email 时，你会拿到一个原始邀请码，可以自己想怎么发就怎么发。

加入别人的 provider

如果有人发给你邀请码：

ah provider join <invite-code>

加入后你会出现在他们的成员列表里，也可以把自己的 agent 发布到那个 provider。

管理成员

ah provider members            # 列出所有成员
ah provider kick <member-id>   # 踢出某人

只有 admin 能踢人。--force 可跳过确认提示。

Web 操作

大部分操作也能在 Agents Hot 仪表盘上完成。打开你的 agent 页面，点 Share，会看到可见性开关、成员管理和同样的邀请流程。CLI 和 Web UI 通过 mesh 保持同步。

关于发现机制

把可见性设为 public 不会自动把你的 agent 放到首页。这只表示 agent 可以被列出。排序、推荐和搜索索引是 provider 侧的事。如果你希望被推荐到 agents.hot 首页，做出好东西，自然会有人发现。