> ## 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.

# Usando o Craft Assistant

> Aprenda a iniciar conversas e trabalhar com o Assistant para entender e transformar seu conteúdo.

O Craft Assistant ajuda a entender e trabalhar com seu conteúdo em linguagem natural. Você pode fazer perguntas, resumir documentos, explorar informações no seu Espaço e, em plataformas compatíveis, editar documentos diretamente.

<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="Interface do Craft Assistant mostrando o painel de conversa" width="209" height="142" data-path="images/ai-assistant/using/en/content/assistant-interface.png" />

## Onde o Craft Assistant está disponível

O Craft Assistant funciona em todas as principais plataformas:

<Tabs>
  <Tab title="macOS">
    Disponível no **nível de espaço e de documento**. Funciona em Documentos, Tarefas, Calendário, Coleções, Editor de Código e visualizações de navegação.
  </Tab>

  <Tab title="iOS">
    Disponível no **nível de espaço e de documento** no iPad e iPhone. Funciona em Documentos, Tarefas, Calendário, Coleções, Editor de Código e visualizações de navegação.
  </Tab>

  <Tab title="Windows">
    Disponível no **nível de espaço e de documento**. Funciona em Documentos, Tarefas, Calendário, Coleções, Editor de Código e visualizações de navegação.
  </Tab>

  <Tab title="Web">
    Disponível no **nível de espaço e de documento**. Funciona em Documentos, Tarefas, Calendário, Coleções, Editor de Código e visualizações de navegação.
  </Tab>
</Tabs>

## Iniciar uma conversa

<Steps>
  <Step>
    Abra um documento ou fique na visualização do seu Espaço.
  </Step>

  <Step>
    Abra o painel do Assistant.
  </Step>

  <Step>
    Escolha um modelo e modo, depois digite seu prompt.
  </Step>

  <Step>
    Revise a resposta ou as alterações aplicadas.
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/ai-assistant/using/en/content/assistant-prompt.png?s=db4cfe1c95f55a14f01ac4ecdf862da3" alt="Assistant mostrando um exemplo de prompt e resposta" width="800" height="476" data-path="images/ai-assistant/using/en/content/assistant-prompt.png" />

## Sessões

As sessões do Craft Assistant foram projetadas para continuidade:

<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="Histórico de Conversa mostrando sessões anteriores" width="1568" height="943" data-path="images/ai-assistant/using/en/content/assistant-sessions.png" />

* As sessões **sincronizam entre seus dispositivos**.
* As sessões são pausadas após **5 minutos** de inatividade. Seu histórico de conversa é preservado.
* Você pode reabrir **sessões anteriores** na lista.
* Você pode executar **sessões paralelas**.
* Um **ponto de notificação** aparece quando uma sessão em segundo plano é concluída.

## Editando seus documentos

No macOS e iOS, use o modo **Execute** para aplicar alterações diretamente. Use o modo **Explore** quando quiser revisar as alterações propostas primeiro.

* **Explore** — propõe alterações e aguarda sua aprovação antes de modificar qualquer coisa.
* **Execute** — aplica as alterações diretamente.

Você pode desfazer a última ação completa do Assistant com **⌘Z (Ctrl+Z)**.

Para detalhes completos de edição, consulte [Editando com o Craft Assistant](/pt-BR/ai-assistant/editing).

<Tabs>
  <Tab title="macOS">
    Suporte completo à edição no nível de documento e de espaço.
  </Tab>

  <Tab title="iOS">
    Suporte completo à edição no nível de documento e de espaço no iPad e iPhone.
  </Tab>

  <Tab title="Windows">
    Assistant disponível, modo Execute chegará em breve.
  </Tab>

  <Tab title="Web">
    Assistant disponível, modo Execute chegará em breve.
  </Tab>
</Tabs>

## Exemplos de perguntas que você pode fazer

**Entendendo seu conteúdo:**

* "O que escrevi sobre este tema no ano passado?"
* "Quais tarefas ainda estão abertas para o Projeto Y?"
* "Resuma todas as notas relacionadas à integração de novos funcionários."

**Trabalhando com conteúdo específico:**

* "Resuma este documento em 3 pontos"
* "Extraia todos os itens de ação desta nota de reunião"
* "Quais são as principais decisões mencionadas aqui?"

**Edição:**

* "Adicione um callout de resumo no topo deste documento"
* "Reestilize os títulos com cores e adicione divisores"
* "Divida isso em subpáginas, uma por seção"
* "Crie um novo documento com as notas de reunião desta página"

**Consultas no nível de espaço:**

* "Encontrar todos os documentos sobre campanhas de marketing"
* "Quais prazos tenho esta semana?"
* "Mostrar tudo relacionado ao projeto do T4"

<Info title="Suporte a Coleções">
  O Assistant pode entender Coleções, incluindo propriedades e relacionamentos.
</Info>

## Privacidade e seus dados

O Craft Assistant foi projetado com privacidade em primeiro lugar:

* As sessões sincronizam entre seus dispositivos para continuidade.
* O Craft não usa seu conteúdo para treinar modelos de IA.
* Apenas os dados mínimos necessários para processar uma solicitação são enviados ao provedor do modelo.
* O uso de tokens e o custo são registrados para rastreamento de uso.

Para detalhes sobre uso de IA, consulte [Uso e Limites](/pt-BR/ai-assistant/usage).

## Escolhendo um modelo

O modelo selecionado altera velocidade, capacidade e uso de IA:

* **Core:** Consultas cotidianas em documentos. Usa uma quantidade baixa de uso de IA. Somente leitura.
* **Fast:** Bom para consultas no nível de espaço e suporta edição.
* **Max:** Melhor para raciocínio complexo e qualidade de edição.
* **Local:** Modelos no dispositivo (Apple Foundation Model, LLaMa 3.2) que rodam localmente no seu dispositivo. Sempre gratuito. Somente leitura.

Apenas **Fast** e **Max** suportam edição.

Consulte [Escolhendo o modelo de IA certo](/pt-BR/ai-assistant/models) para detalhes.

## 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>

## Desativar o Assistant

Você pode desativar o Assistant por Espaço:

<Steps>
  <Step>
    Abra as configurações do Espaço.
  </Step>

  <Step>
    Desative o botão do Assistant.
  </Step>
</Steps>

<Warning title="Configuração por Dispositivo">
  Essa configuração não é sincronizada entre dispositivos ou usuários. Se você desativá-la em um dispositivo, ela permanece ativada nos outros até ser alterada lá também.
</Warning>

## Artigos Relacionados

<CardGroup cols={2}>
  <Card title="Escolhendo Modelos de IA" href="/pt-BR/ai-assistant/models">
    Selecione o modelo certo para sua tarefa e necessidades de edição
  </Card>

  <Card title="Editando com o Craft Assistant" href="/pt-BR/ai-assistant/editing">
    Deixe o Assistant fazer alterações diretamente nos seus documentos
  </Card>

  <Card title="Prompts Personalizados" href="/pt-BR/ai-assistant/custom-prompts">
    Crie instruções reutilizáveis para resultados consistentes
  </Card>

  <Card title="Suporte a Imagens e PDF" href="/pt-BR/ai-assistant/ocr-images-pdfs">
    Use OCR para extrair texto e gerar descrições
  </Card>

  <Card title="Agente de Ajuda" href="/pt-BR/ai-assistant/help-agent">
    Obtenha ajuda instantânea sobre os recursos do Craft sem sair do app
  </Card>
</CardGroup>
