# Notas com IA

Pergunte ao assistente ou a um agente de CLI sobre uma nota, aceite ou recuse as mudanças que ele sugere e traga arquivos das tarefas de pesquisa.

As Notas são um experimento e ficam desligadas até você ativá-las. Veja [Ative as Notas](/docs/notes/#turn-on-notes).

Cada nota tem o próprio assistente. Ele lê a nota e responde a perguntas sobre ela. Quando você pede uma mudança, ele sugere uma, e a mudança aparece na nota até você aceitá-la ou recusá-la.

## O que você precisa

| Para usar | Configure |
| --- | --- |
| **Agente do Oleafly**, o assistente embutido | Um provedor ou um modelo local em **Configurações → Assistente de IA**. Veja [Configurar a IA](/docs/ai-setup/). Sem um, o assistente mostra **Conectar um provedor**. |
| **Agente de CLI** | Um agente conectado em **Configurações → Assistente de IA → Agentes de CLI**. Ele roda com o login do próprio agente. Veja [Agentes de CLI](/docs/cli-agents/). |
| Tarefas de pesquisa e os arquivos que elas criam | **Tarefas de pesquisa** ativadas em **Configurações → Experimentação** e uma nota vinculada a um projeto. Veja [Tarefas de pesquisa](/docs/research-tasks/). |
| Um cliente MCP fora do Oleafly | **Ativar o servidor MCP** em **Configurações → Integrações → Oleafly MCP**. Veja [Conecte via MCP](/docs/mcp/). |

## Abra o assistente

O assistente fica na parte de baixo da nota. Recolhido, é um pequeno botão **Assistente** que também nomeia o modo, **Agente do Oleafly** ou **Agente de CLI**.

- Selecione **Assistente**, ou pressione ⌘J (Ctrl+J) na nota.
- Para recolhê-lo, selecione **Ocultar o prompt**, ou pressione as mesmas teclas enquanto o prompt está vazio.
- Para perguntar sobre um trecho, selecione-o e escolha **Perguntar ao agente** na barra pequena junto à seleção, ou pressione ⌘J (Ctrl+J). O trecho entra na sua mensagem.

Enquanto o assistente trabalha, um botão **Parar** aparece ao lado do botão **Assistente** recolhido.

Para usar outras teclas, mude **Notas: perguntar ao agente** na aba **Notas** de **Configurações → Atalhos de teclado**.

Com o **Agente do Oleafly**, cada nota guarda as próprias conversas. **Nova conversa** começa uma nova, e **Histórico de conversas** abre as anteriores.

Quando pelo menos um agente de CLI está pronto, uma chave no topo do assistente escolhe **Agente do Oleafly** ou **Agente de CLI**. O seletor de modelos também lista os seus agentes em **Agentes de CLI**, e escolher um troca a nota para **Agente de CLI**.

![Na nota Literature review matrix, a chave no topo do assistente está em Agente de CLI, com o Gemini CLI escolhido na fileira de agentes acima do prompt.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-assistant-dark-window-v2.png#view=1138,0,782,1200)

Em uma nota que você só pode ler, você não pode perguntar nada ao assistente em nenhum dos modos. O prompt é substituído por “Você só pode visualizar esta nota, então o assistente não pode alterá-la.”

## Pergunte ao Agente do Oleafly

Digite uma pergunta ou um pedido. O prompt vazio diz “Pergunte sobre esta nota ou peça uma alteração. Digite / para ver as ações”.

- Digite `@` e escolha outra nota para enviar o texto dela com a sua mensagem.
- Digite `/` para ações de pesquisa. Cada uma envia na hora um pedido escrito sobre a nota.

| Ação | O que ela pede |
| --- | --- |
| **Atualizar com a última execução** | Os resultados da última tarefa de pesquisa do projeto vinculado, usando só os números que ela informa. Aparece quando esse projeto tem uma tarefa concluída. |
| **Conferir as afirmações com o código** | Uma conferência de cada afirmação com o código, os dados e o artigo do projeto vinculado, com correções e uma lista das afirmações que ele não conseguiu verificar. Aparece quando a nota está vinculada a um projeto. |
| **Encontrar citações** | Citações `[@key]` de referências que ele consegue encontrar e verificar. As afirmações sem uma fonte confirmada vão para uma seção chamada Citações a encontrar, com termos de busca. |
| **Revisar a seleção** | Correções de ortografia, gramática e pontuação no trecho selecionado. Sem nada selecionado, aparece como **Revisar a nota**. |
| **Reescrever a seleção** | O trecho selecionado reescrito para ficar mais claro, mantendo todos os fatos e números. Sem nada selecionado, aparece como **Reescrever a nota**. |
| **Deixar mais curto** | Uma nota mais curta que mantém todos os fatos, números e citações. |
| **Escrever um novo parágrafo** | Um parágrafo novo no lugar certo, a partir do que esta nota e as suas outras notas já dizem. |
| **Adicionar tabela comparativa** | Uma tabela montada com fatos que já estão na nota. |
| **Adicionar uma figura** | Um diagrama Mermaid ou um bloco de gráfico com dados da nota. |
| **Sintetizar para o resumo** | Uma seção chamada Resumo no começo, com três a cinco frases que poderiam abrir um resumo. |

### Com o que o Agente do Oleafly trabalha

Com cada mensagem, ele recebe:

- O título e o texto da nota, até 12.000 caracteres. Ele pode ler o resto quando precisar.
- O nome do projeto vinculado.
- Quantas sugestões estão esperando a sua revisão.
- Os nomes dos arquivos ao lado da nota.
- Quantas notas você tem e os títulos das 15 que você editou por último.

Ele também pode:

- Buscar e ler as suas outras notas.
- Ler, adicionar e mudar os outros arquivos na pasta da nota, como as imagens e os dados dela, e executar comandos ali. Ele muda a própria nota só por sugestões.
- Criar uma nota nova. O cartão de aprovação mostra primeiro o **Título**, o **Projeto vinculado**, as **Tags** e o **Texto** dela.
- Listar, ler e buscar os arquivos do projeto vinculado, como o artigo, o código e os dados. Ele não os muda.
- Iniciar uma tarefa de pesquisa no projeto vinculado, quando **Tarefas de pesquisa** está ativado.

Ele faz menos em algumas notas:

- Em uma nota compartilhada, ele não vê as suas outras notas, então não há nada para mencionar com `@` ou buscar.
- Em uma nota de projeto, ele não pode mudar arquivos do projeto nem executar comandos.

## Pergunte a um agente de CLI

Um agente de CLI trabalha em uma pasta, e a pasta depende da nota. Em uma nota compartilhada, o Oleafly diz ao agente para ficar dentro dessa pasta. Os pedidos de permissão do agente funcionam como em qualquer projeto. Veja [Pedidos de permissão](/docs/cli-agents/#permission-requests).

### Uma nota sem projeto

O agente trabalha na pasta da própria nota e edita ali o arquivo da nota. O Oleafly mostra cada mudança na nota como uma sugestão. Se você fecha a nota enquanto o agente ainda está trabalhando, o Oleafly tira as mudanças dele do arquivo quando ele termina e as guarda como sugestões para quando você abrir a nota de novo.

### Uma nota vinculada ou uma nota de projeto

O agente trabalha na pasta do projeto, e o texto da nota (os primeiros 60.000 caracteres) vai junto com a sua mensagem. O Oleafly pede ao agente para ler o projeto e deixar os arquivos dele em paz, e coloca o agente no modo somente leitura ou de planejamento, quando ele tem um. As mudanças que ele quer na nota voltam como sugestões.

- Se o agente não tem um modo somente leitura, o Oleafly avisa que ele poderia mudar arquivos do projeto e pergunta se deve enviar a sua mensagem mesmo assim. Escolha **Enviar mesmo assim** ou **Não enviar**.
- Enquanto o agente não está em um modo somente leitura, o assistente diz “Este agente pode alterar arquivos no projeto vinculado.”

## Revise as mudanças sugeridas

As mudanças sugeridas ficam destacadas na nota, e uma barra de revisão fica junto à atual.

- **Aceitar**, ou ⌘↵ (Ctrl+Enter), mantém a mudança.
- **Recusar** a descarta. **Desfazer**, ou ⌘Z (Ctrl+Z), traz de volta o que você acabou de recusar.
- Com mais de uma mudança, **Mudança anterior** e **Próxima mudança** passam de uma para outra, e **Aceitar tudo** ou **Recusar tudo** resolve todas.

Em uma nota pessoal, o Oleafly salva uma versão antes de **Aceitar tudo** aplicar as mudanças. Para voltar a ela, escolha **Mais → Histórico de versões** no cabeçalho da nota. Veja [Histórico de versões](/docs/notes/writing/#version-history).

As sugestões para uma nota que não está aberta esperam neste computador até você abri-la. Um ícone ao lado da nota na barra lateral e no Início das Notas diz “Há alterações sugeridas esperando nesta nota”. As mudanças que outro programa faz em uma nota aberta também aparecem como sugestões, a menos que você esteja editando a nota em tempo real com outras pessoas. Veja [Edite uma nota em outro programa](/docs/notes/#edit-a-note-in-another-program).

## Arquivos das tarefas de pesquisa

Com **Tarefas de pesquisa** ativado, uma nota vinculada a um projeto reúne os arquivos que as tarefas de pesquisa desse projeto criam.

1. Abra a nota nas Notas.
2. Selecione o botão **Artefatos**, o ícone de painel no canto superior direito das Notas. O selo dele conta os arquivos do projeto da nota.
3. Escolha um arquivo. O painel mostra o tipo dele, o agente que o criou, quando, **Da tarefa** com o nome da tarefa, o caminho dele, uma prévia e o resumo da tarefa.
4. Selecione **Inserir na nota** para copiar o arquivo para a nota. O Oleafly o adiciona no fim da nota: uma figura como imagem (uma figura em PDF como link), um notebook como um bloco de notebook e qualquer outra coisa como link.

Cada arquivo tem um tipo: **Figura**, **Figura interativa**, **Relatório**, **Dados**, **Notebook** ou **Arquivo**. Uma figura interativa não tem prévia no painel. Para executá-la, cole o código dela em um bloco HTML em uma nota e selecione **Executar**.

## Código que um agente adiciona

Quando um agente adiciona um bloco HTML com um script ou um bloco React, o bloco espera por **Executar**, como esperaria se você o tivesse adicionado. Se você marcou **Sempre executar este bloco**, uma mudança de um agente no código faz o bloco esperar por **Executar** de novo. Veja [Blocos que executam código](/docs/notes/writing/#blocks-that-run-code).

## Notas vinculadas no assistente do projeto

Com as Notas ativadas, o Agente do Oleafly em um projeto também recebe os títulos e um resumo curto de até 12 notas pessoais vinculadas a esse projeto, das editadas mais recentemente para as mais antigas. Em um projeto compartilhado, ele as deixa de fora. [Vincule uma nota a um projeto](/docs/notes/projects-and-sharing/#link-a-note-to-a-project) mostra como vincular uma.

## Clientes MCP

Com as Notas ativadas, um cliente MCP conectado ao Oleafly pode listar, buscar e ler as suas notas, ler a nota diária de hoje, listar tarefas e backlinks, adicionar texto ao fim de uma nota e reescrever uma seção dela. As mudanças dele chegam à nota como sugestões. Criar uma nota, inclusive a nota diária de hoje, espera pela sua aprovação no Oleafly. Uma nota compartilhada pode ser lida, mas não alterada por aqui. Veja [Conecte via MCP](/docs/mcp/).
