> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 Craft Assistant

> 了解如何开始对话，并使用 Assistant 理解和转化您的内容。

Craft Assistant 帮助您通过自然语言理解和处理内容。您可以提问、归纳文档、探索空间中的信息，在支持的平台上还可以直接编辑文档。

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/ai-assistant/using/en/content/assistant-interface.png?fit=max&auto=format&n=bXGV3J9qfsAQZqJz&q=85&s=c9647eefaea822f38e79503350d83b28" alt="Craft Assistant interface showing conversation panel" width="209" height="142" data-path="images/ai-assistant/using/en/content/assistant-interface.png" />

## Craft Assistant 的支持平台

Craft Assistant 支持所有主流平台：

<Tabs>
  <Tab title="macOS">
    支持**空间级别和文档级别**，适用于文档、任务、日历、收藏集、代码编辑器和浏览视图。
  </Tab>

  <Tab title="iOS">
    在 iPad 和 iPhone 上支持**空间级别和文档级别**，适用于文档、任务、日历、收藏集、代码编辑器和浏览视图。
  </Tab>

  <Tab title="Windows">
    支持**空间级别和文档级别**，适用于文档、任务、日历、收藏集、代码编辑器和浏览视图。
  </Tab>

  <Tab title="Web">
    支持**空间级别和文档级别**，适用于文档、任务、日历、收藏集、代码编辑器和浏览视图。
  </Tab>
</Tabs>

## 开始对话

<Steps>
  <Step>
    打开一个文档，或停留在空间视图中。
  </Step>

  <Step>
    打开 Assistant 面板。
  </Step>

  <Step>
    选择模型和模式，然后输入您的提示词。
  </Step>

  <Step>
    查看回复或已应用的更改。
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/ai-assistant/using/en/content/assistant-prompt.png?s=db4cfe1c95f55a14f01ac4ecdf862da3" alt="Assistant showing example prompt and response" width="800" height="476" data-path="images/ai-assistant/using/en/content/assistant-prompt.png" />

## 会话

Craft Assistant 的会话设计注重连贯性：

<img src="https://mintcdn.com/craft-support/8R3j8_MOUDKwTvNH/images/ai-assistant/using/en/content/assistant-sessions.png?fit=max&auto=format&n=8R3j8_MOUDKwTvNH&q=85&s=25b9e314a988f246b89800bd1a115482" alt="Conversation History showing past sessions" width="1568" height="943" data-path="images/ai-assistant/using/en/content/assistant-sessions.png" />

* 会话**跨设备同步**。
* 会话在**5 分钟**无操作后暂停，对话历史会被保留。
* 可以从列表中重新打开**历史会话**。
* 可以**并行运行多个会话**。
* 后台会话完成时，会出现**通知圆点**。

## 编辑您的文档

在 macOS 和 iOS 上，使用**执行**模式直接应用更改；使用**探索**模式可先查看提议的更改再决定是否应用。

* **探索** — 提议更改方案，等待您确认后才会进行任何修改。
* **执行** — 直接应用更改。

可以使用 **⌘Z（Ctrl+Z）** 撤销 Assistant 上一次操作的全部内容。

完整的编辑详情，请参阅[使用 Craft Assistant 编辑文档](/zh-Hans/ai-assistant/editing)。

<Tabs>
  <Tab title="macOS">
    文档级别和空间级别均完全支持编辑。
  </Tab>

  <Tab title="iOS">
    在 iPad 和 iPhone 上，文档级别和空间级别均完全支持编辑。
  </Tab>

  <Tab title="Windows">
    Assistant 可用，执行模式即将推出。
  </Tab>

  <Tab title="Web">
    Assistant 可用，执行模式即将推出。
  </Tab>
</Tabs>

## 示例提问

**理解您的内容：**

* "我去年写过什么关于这个话题的内容？"
* "项目 Y 还有哪些任务未完成？"
* "总结所有与新员工入职相关的笔记。"

**处理特定内容：**

* "用 3 个要点总结这篇文档"
* "提取这份会议记录中的所有行动项"
* "这里提到的关键决策有哪些？"

**编辑文档：**

* "在文档顶部添加一个摘要标注框"
* "用颜色重新设置标题样式并添加分隔线"
* "将文档拆分为子页面，每个章节一页"
* "根据本页内容创建一份新的会议记录文档"

**空间级查询：**

* "查找所有关于营销活动的文档"
* "我本周有哪些截止日期？"
* "显示所有与 Q4 项目相关的内容"

<Info title="收藏集支持">
  Assistant 可以理解收藏集，包括属性和关联关系。
</Info>

## 隐私与数据

Craft Assistant 以隐私优先为设计原则：

* 会话跨设备同步以保持连贯性。
* Craft 不会使用您的内容训练 AI 模型。
* 仅将处理请求所需的最少数据发送给模型提供商。
* 记录 token 用量和费用用于使用量追踪。

AI 使用量详情，请参阅[使用量与限制](/zh-Hans/ai-assistant/usage)。

## 选择模型

所选模型影响速度、能力和 AI 使用量：

* \*\*Core：\*\*适合日常文档内查询。AI 用量较低。只读。
* \*\*Fast：\*\*适合空间级问题，支持编辑。
* \*\*Max：\*\*最适合复杂推理和高质量编辑。
* \*\*Local：\*\*在设备上本地运行的模型（Apple Foundation Model、LLaMa 3.2）。始终免费。只读。

仅 **Fast** 和 **Max** 支持编辑。

详情请参阅[选择合适的 AI 模型](/zh-Hans/ai-assistant/models)。

## Preferences

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/_wA60pYNPJQ" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

Preferences let you give the Assistant background information that applies to every conversation. Unlike custom prompts, which you select per task, preferences are always active regardless of which model or provider you use.

Use preferences for things like your preferred language, tone, response length, or role context.

### Add a preference

<Steps>
  <Step title="Open Settings">
    Go to **Settings** > **Assistant**.
  </Step>

  <Step title="Find Preferences">
    Scroll to the **Preferences** section.
  </Step>

  <Step title="Add Preference">
    Tap **Add Preference**, type your instruction, and tap **Add**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/using/en/content/preferences-section.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=61dc95d450f0a4f478800c7b386557e3" alt="Preferences section in Assistant settings with Add Preference button" width="1091" height="953" data-path="images/ai-assistant/using/en/content/preferences-section.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/using/en/content/preferences-add-dialog.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=87224b57875d7d10139924d19f7e7140" alt="Add Preference dialog with example text" width="1091" height="953" data-path="images/ai-assistant/using/en/content/preferences-add-dialog.png" />
</Frame>

### Example preferences

* "Use British English spelling"
* "Keep responses under 3 paragraphs"
* "I work in marketing. Use brand-friendly language"
* "Always respond in Spanish"
* "When summarizing meetings, always extract action items with owners"

### Manage preferences

To edit or delete a preference, tap the **3-dots button** next to it and choose **Edit** or **Delete**.

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/using/en/content/preferences-manage.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=1488576dbca73a54eb52b841ce161604" alt="Preferences list showing Edit and Delete options" width="1091" height="953" data-path="images/ai-assistant/using/en/content/preferences-manage.png" />
</Frame>

## 关闭 Assistant

您可以按空间单独关闭 Assistant：

<Steps>
  <Step>
    打开空间设置。
  </Step>

  <Step>
    关闭 Assistant 开关。
  </Step>
</Steps>

<Warning title="设备专属设置">
  此设置不会跨设备或跨用户同步。如果您在一台设备上关闭，其他设备上仍保持开启状态，需在各设备上分别修改。
</Warning>

## 相关文章

<CardGroup cols={2}>
  <Card title="选择 AI 模型" href="/zh-Hans/ai-assistant/models">
    为您的任务和编辑需求选择合适的模型
  </Card>

  <Card title="使用 Craft Assistant 编辑文档" href="/zh-Hans/ai-assistant/editing">
    让 Assistant 直接在您的文档中进行更改
  </Card>

  <Card title="自定义提示词" href="/zh-Hans/ai-assistant/custom-prompts">
    创建可复用的指令以获得一致结果
  </Card>

  <Card title="图片与 PDF 支持" href="/zh-Hans/ai-assistant/ocr-images-pdfs">
    使用 OCR 提取文字并生成描述
  </Card>

  <Card title="帮助助手" href="/zh-Hans/ai-assistant/help-agent">
    无需离开应用即可获得 Craft 功能的即时帮助
  </Card>
</CardGroup>
