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

# Notion

> Deixe agents pesquisarem, lerem e escreverem nas páginas do Notion que você escolher compartilhar

Conecte o Notion e seus agents passam a usar a base de conhecimento do seu time como um colega bem informado usaria: encontrar a página certa, lê-la, responder a partir dela, consultar seus databases — e, onde você permitir, escrever páginas novas e manter databases em dia.

O essencial para entender o Notion: **agents só veem o que você compartilha**. Durante a conexão, o Notion pergunta quais páginas e databases a integração da Leme pode acessar. Todo o resto permanece invisível.

## O que os agents podem fazer

| Capacidade                         | Detalhes                                                                                |
| ---------------------------------- | --------------------------------------------------------------------------------------- |
| Pesquisar o conteúdo compartilhado | Encontrar páginas e databases por nome ou assunto.                                      |
| Ler páginas                        | Conteúdo completo da página, incluindo a estrutura aninhada.                            |
| Ler schemas de databases           | Propriedades, tipos e opções — para queries e edições que se encaixam na sua estrutura. |
| Consultar databases                | Filtrar e ordenar entradas, como "tudo com status Blocked".                             |
| Criar páginas                      | Páginas novas sob uma página ou database compartilhado, com conteúdo rico.              |
| Anexar a páginas                   | Adicionar conteúdo ao final de uma página existente.                                    |
| Atualizar entradas de databases    | Mudar valores de propriedades em entradas existentes.                                   |
| Comentar em páginas                | Visível para todos no workspace.                                                        |

A leitura roda livremente por padrão; criar, editar e comentar pedem aprovação. Veja [Permissões](#permissões).

## Experimente perguntar

* *"O que o nosso runbook de onboarding diz sobre conceder acesso à produção?"*
* *"No database de Projetos, o que está bloqueado e quem é dono de cada item?"*
* *"Resuma as notas da reunião de product review de terça-feira passada."*
* *"Documente esta conversa como uma página de decisão em Engineering / Decisions."* — criada após aprovação.
* *"Marque a entrada 'Q3 pricing' como Done no database do Roadmap."* — aplicado após aprovação.

## Conectar o Notion

<Steps>
  <Step title="Abra Integrações">
    No dashboard da Leme, acesse **Integrações** e selecione **Notion**.
  </Step>

  <Step title="Escolha o que compartilhar">
    Selecione **Conectar**. A tela de consentimento do Notion deixa você escolher as páginas e os databases que a integração pode acessar — dá para selecionar seções inteiras ou páginas individuais. Escolha com critério; você sempre pode compartilhar mais depois.
  </Step>

  <Step title="Habilite nos seus agents">
    Vincule a conexão aos agents que devem usá-la e revise as **Permissões de agent**.
  </Step>
</Steps>

O Notion é uma conexão **compartilhada**: as páginas compartilhadas com a integração são o que todo agent habilitado consegue alcançar.

## Compartilhar mais (ou menos) depois

O acesso é gerenciado dentro do Notion, página a página:

* Para compartilhar uma página depois de conectar: abra-a no Notion → menu **•••** → **Conexões** → adicione a integração da Leme. Subpáginas herdam o acesso da página pai.
* Para descompartilhar: remova a integração das conexões da página. O agent perde o acesso imediatamente.

## Permissões

| Ação                                               | Categoria           | Padrão          |
| -------------------------------------------------- | ------------------- | --------------- |
| Pesquisar, ler páginas, consultar databases        | Leitura             | Permitir        |
| Criar páginas, anexar conteúdo, atualizar entradas | Escrita             | Pedir aprovação |
| Comentar em páginas                                | Comunicação externa | Pedir aprovação |

Ajuste em **Integrações → Notion → Permissões de agent** — veja [Permissões e aprovações](/pt-BR/permissions). O escopo de compartilhamento (quais páginas) e as permissões (o que pode ser feito com elas) se compõem: um agent precisa dos dois.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O agent não encontra uma página que existe">
    A página não está compartilhada com a integração. No Notion, abra a página → **•••** → **Conexões** → adicione a Leme. Lembre que subpáginas herdam das páginas pai, então compartilhar uma seção costuma bastar.
  </Accordion>

  <Accordion title="Uma query em database não retorna nada, mas o database tem entradas">
    Ou o database em si não está compartilhado (compartilhar uma página não compartilha automaticamente databases vinculados de outros lugares), ou o filtro não corresponde ao seu schema. Peça ao agent para ler o schema do database primeiro — ele verá os nomes e as opções reais das propriedades.
  </Accordion>

  <Accordion title="Uma atualização foi rejeitada por propriedade desconhecida">
    Nomes de propriedades precisam corresponder exatamente ao schema do database. O agent recebe a lista válida quando isso acontece e tenta de novo — se continuar falhando, a propriedade pode ter sido renomeada; peça ao agent para reler o schema.
  </Accordion>
</AccordionGroup>