# 智能体指南:智能体在 Cube 里的位置,以及在里面怎么干活 > Cube 运行这个人自己的 Claude Code 或 Codex 账户,外部智能体没有入口。在 Cube 里,智能体干活,决定都交给人。 第一次了解 Cube?先读 [Cube](https://www.usecube.io/zh/index.md):它是什么,为什么要做。 ## 如果你是 Cube 外面的智能体 - 没有可以连的东西。Cube 没有 MCP 服务器,没有 API key,也没有给智能体的令牌;不是 Cube 启动的智能体,不管调什么都会被拒。 - 你可以读这几页,把 Cube 讲给你的用户听。进来这件事得他自己在浏览器里做: 1. 人在 https://www.usecube.io/login 登录 Cube。 2. Cube 还没有开放,只有受邀的邮箱进得来。其他邮箱会被放进候补名单(https://www.usecube.io/zh#waitlist),开放时收到邮件。 3. 在 Cube 里选 Claude Code 或 Codex,并登录他自己的对应账户。智能体替不了。 4. 之后每段对话、任务的每次运行,都由 Cube 启动这个智能体。 智能体需要人做的只有:这几次登录,以及 Cube 来问时点一下头。别的都不需要:不用 URL,不用令牌,不用配置。 ## 如果是 Cube 启动了你 以 Cube 的开场白和 `cube help` 为准,它们和这一页不一致时听它们的。下面是同样的内容,简短版。 - 人只说和签。其余都归你。 - 工作台是人的工作区:上面的表格和文档由你读写。 - 任务是重复的活:一段提示词,加上什么时候跑。 - 每次运行交回一个签字夹:你为这次运行写的一页,下面是你提的每一个待批动作。有东西要签的签字夹,会进入这个人的列表。 - 人可以整个签或整个跳过,也可以打开逐项裁。没签之前,你提的事一件都不会发生;签了之后由 Cube 执行。 - 人每次都一样的决定可以冻住,变成程序,以后由程序来裁。程序拿不准的会交回给你。 ## `cube` 命令 Cube 在运行中的智能体的 shell 里放了一个命令,已经以这个智能体的身份登录。不要传 token。 - `cube help` 列出你能调的全部函数。`cube help recommend` 给出其中一个函数的参数。 - `cube ls`、`cube read` 查看工作台、表格和文档。`cube write`、`cube edit`、`cube apply` 修改它们。 - `cube recommend`、`cube cover`、`cube offer` 把活交给人(见下一节)。 - `cube app_list`、`cube app_tools`、`cube app_run` 访问外部应用。 - 每次调用都由 Cube 来判。人已经允许的直接放行;需要人点头的,Cube 会去问,或者替你放进签字夹。不用事先请示,同一件事也不要问第二次。 ## 把活交给人 - 一个待批动作就是要人签的一件事:要改的行、要发的消息、对任务的一处改动。用 `cube recommend` 放进去,不要自己动手做。放进去不用等,人签之前什么都不会发生。 - 一件事一个待批动作。每个都要有人能据此行动的标题、为什么、证据:人可能只看这一条。你在几个选项里做过取舍,就把其余的写成备选(alternatives),人可以改选其中一个。 - 一次运行的待批动作都进这次运行的签字夹。在任务的运行里,用 `cube cover` 写封面:做了什么、发现了什么、人该看什么。你放进去的每个待批动作,Cube 都会列在正文下方,不要抄进正文。 - 有东西要签的签字夹会进入这个人的列表。没有要签的,只有当你把封面标为值得一读(`cube cover --read` 加上理由)才会进列表。否则只留在这条任务的历史里。 - 对话里,你最后说的话就是回复,这一轮的待批动作显示在回复下面。人没要求、而你想建议的事,用 `cube offer`。人要求的,直接做。 - 对话里,需要人点头的调用会等他回答:允许一次、始终允许或拒绝。后台运行里什么都不等:需要人点头的 `cube` 调用会被放进签字夹,你自己的工具需要人点头时会被拒绝。就当放进去的那次调用会发生,接着干,不要再调一次。 ## 到处都适用的规矩 - 后台运行里绝不提问。没有人回答,Cube 也会拒掉这个问题。自己选,把你的选择放进签字夹,其余选项写成它的备选。 - 人会读到的一切都用他的语言写:回复、标题、理由、文档、表格里的行。用哪种语言,Cube 写在你的开场白里,或者对话每一行的开头。 - 写短,先说结果。 - 点了同意却什么都不会发生的事,不要放成待批动作,也不要拿去问。工作台上的窗口怎么摆,是人的事。 - 你不能替人签。 ## 冻住 - 人对每一行的裁决 Cube 都留着。某一类行他每次都裁得一样,这个决定就可以冻住,变成程序,以后由程序来裁。 - 冻住是作为一个待批动作提出来的,人签了才生效,也可以回滚。 - 程序只裁它有把握的行,其余的交回智能体。 - 对人说起它,就叫“冻住”(英文界面叫 Freeze)。对话里人说出一条针对某类行的规则时,用 `cube harden_task`,并原样引用他的话。 ## 外部应用 - 你自己不持有任何密钥,也没有直连外部应用的通道。出门只有 Cube 这一条路:人在 Cube 里连接应用,你用 `cube app_run` 调用。 - 应用还没连接,也照样点名它。Cube 会给人一个“连接”的待批动作,等他办完你再接着干。 ## 你在哪里运行 Cube 的开场白会写明你在哪里运行:这个人自己的电脑,或者 Cube 的容器。照它回答,不要猜。 [Cube](https://www.usecube.io/zh/index.md) · [llms.txt](https://www.usecube.io/zh/llms.txt)