> ## Documentation Index
> Fetch the complete documentation index at: https://docs.okcheese.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 队友 {#agents}

AI 队友是在项目里替你干活的「芝士」。每个项目至少一位，名字在建项目时取（比如「小苔」），界面上显示的就是这个名字，下文统一叫它芝士。一个项目可以有多位队友；新话题默认用标着「默认」的那位。

## 修改 AI 队友 {#edit-agent}

AI 队友的名字、角色设定和模型，都在「项目设置 → AI 队友」里改。

1. 在话题页面点项目标题旁的「项目菜单」，选择「项目设置」。
2. 选左边的「AI 队友」，在对应队友的卡片上点「编辑」。
3. 在「修改 AI 队友」弹窗里改「名字」「角色设定」或模型。
4. 点「保存」。

![项目设置的「AI 队友」一栏：AI 队友卡片（标着默认），右侧有「编辑」「停用」；下面是默认模型设置](https://docs.okcheese.com/images/settings.jpg)

弹窗里还有队友的「标识」（`@` 它时用的名字）。弹窗提示：「修改只影响这个队友，下次运行时生效，已有记忆保留」。

从项目「成员」页也能到这里：在「AI 队友」区域点队友旁的「设置」，再点「编辑」。

## 项目默认 AI 队友 {#default-agent}

新建话题用项目里标着「默认」的那位队友，创建话题时没有选择队友的步骤。

## 在话题中更换 AI 队友 {#change-agent-in-topic}

只有项目拥有者和管理员能改话题成员。其他人打开名册会看到「只有拥有者和管理员能修改成员」。

1. 点话题顶部的「话题成员」。
2. 在当前 AI 队友那一行点 ✕（「移出话题」）。
3. 在下面「添加成员…」下拉里选另一位 AI 队友，点「加入」。

完成后：名册和输入框旁「交给」按钮上的名字都换成新队友。被移出的队友如果正在处理消息，会马上停下，已经写出的内容保留。

## 让 AI 队友处理消息 {#summon}

AI 队友空闲时，只有明确指定由它处理消息，才会开始执行。指定方式有三种：


**什么时候会叫起一位队友**（网页上是可以逐步播放的演示，这里是同一份内容的文字版。）

- 普通消息，不叫它：没点名 AI 队友的消息只留在话题里。人和人在话题里商量事情随便说，不会把芝士叫起来。
- @ 它，或点「交给」：在消息里 @ 队友，或点输入框旁的「交给〈队友名字〉」按钮；按 ⌘/Ctrl+Enter 是同一个 @，写进正文。点到谁，谁开工。
- 它在跑时再发，并进当前一轮：它正在跑的时候再发补充要求，不用等它跑完，直接并进当前这一轮——它在下一步之前就读到。
- 两位队友，点谁谁接：一个话题里有几位队友时，点谁的名字谁接这一轮，别人不会跟着开工。


- 在消息里 `@` 队友后发送。
- 点输入框旁的「交给〈队友名字〉」按钮。
- 按 `Ctrl/Cmd+Enter`，发送并交给队友。

想让它处理已经发出去的内容，再发一条 `@` 它的消息，比如「@芝士 按上面说的做」。上一轮失败时，失败提示上有「重试」按钮。

队友正在执行时，后续普通消息和补充要求在正常送达后会进入当前一轮。补充要求和消息排队时的处理方法见[与芝士协作](https://docs.okcheese.com/working-with-cheese#add-context)。

一个话题里有几位 AI 队友时，点谁的名字谁接这一轮。没点名的消息每个在跑的轮次都看得见，但只有被点名唤起的那个轮次（或房间默认队友的轮次）认领它。

## 设置模型 {#runtime-and-model}

AI 队友可以用单独指定的模型，也可以用项目主模型。在「修改 AI 队友」弹窗里设置「为这个队友指定模型」；不指定时用项目主模型。
