---
title: "Pessoas e agentes sobre um núcleo compartilhado"
description: "Uma base igualmente aberta a pessoas e agentes de IA: as edições de um agente são versionadas, limitadas pelo acesso e registram sua proveniência."
---

# Pessoas e agentes sobre um núcleo compartilhado

A tese central do Notarium: a mesma base de conhecimento está igualmente disponível para pessoas e agentes de IA. Uma pessoa trabalha pela interface web (REST), um agente pelo endpoint MCP embutido, e ambos veem o mesmo grafo de notas sobre um único núcleo portável. Isso não é um "modo bot" pregado por fora — é paridade de recursos por concepção.

## Um núcleo, muitos transportes

A arquitetura se apoia em um único princípio: a lógica de domínio vive em um só núcleo, e os transportes apenas adaptam o acesso a ele.

```mermaid
flowchart LR
  human([Pessoa]) -->|REST · editor web| core
  agent([Agente de IA]) -->|MCP · POST /mcp| core
  core[Núcleo do Notarium] --> files[(Arquivos Markdown)]
```

Quem decide é sempre o núcleo, não o transporte. Por isso uma nota criada por um agente percorre exatamente o mesmo caminho que uma edição feita no editor: é gravada no mesmo arquivo `.md`, versionada no registro, limitada pelo mesmo acesso e recebe um registro de proveniência.

## O que significa "paridade"

A edição de um agente e a edição de uma pessoa são indistinguíveis na forma como são processadas:

- **Versionamento.** Toda edição é uma revisão no registro, vinculada a um `notarium-id`. Veja [Histórico de versões](/docs/concepts/versioning/).
- **Escopo.** O token de um agente não concede mais do que a participação do principal: um token somente leitura nem sequer enxerga as ferramentas de escrita. Veja [Modelo de acesso](/docs/concepts/access-model/).
- **Proveniência.** Cada revisão mostra de onde veio a edição: uma pessoa (`user:<nome>`), um agente específico (`pat:<nome>:<id>`) ou um editor de arquivos externo. Quem editou o quê, e como, é sempre transparente.

> [!note] Proveniência, não anonimato
> As edições de um agente não se dissolvem num histórico compartilhado. Você sempre pode abrir uma nota e ver que esta linha específica foi adicionada por um agente específico sob um token específico — e revertê-la se precisar.

## Como um agente trabalha

Um agente alcança a base de conhecimento por um único endpoint, `POST /mcp` — um conjunto restrito de **21 comandos prontos** (criar uma nota, recuperar contexto, buscar, gravar memória), e não operações de baixo nível sobre o armazenamento. As ferramentas expressam a intenção, enquanto o sistema impõe a colocação e a classe da nota: o agente endereça um projeto pelo nome, mas **não escolhe** o espaço nem a classe da nota (uma proteção contra erros).

O ponto de entrada típico é uma chamada `start_session`: o agente recebe um perfil, a lista de seus projetos e o contexto relevante. A conexão e o conjunto completo de ferramentas estão descritos em [Agentes e MCP](/docs/agents/); o primeiro passo prático é [Conectar um agente](/docs/getting-started/connect-agent/).

## Limites traçados deliberadamente

Um núcleo compartilhado não significa que o agente possa fazer tudo:

- **Um agente não tem exclusão irreversível.** Sobrescrever, sim (é reversível pelo registro); exclusão permanente de contêineres, não.
- **Sem operações entre espaços.** Um agente trabalha estritamente dentro dos espaços que consegue alcançar.
- **As ferramentas não têm canal para o mundo externo**, e conteúdo não confiável nunca é misturado às suas descrições — isso rompe a cadeia "dados privados × entrada não confiável × caminho de saída".
- **O Notarium deliberadamente não é um produto E2EE**: um servidor inteligente precisa ver o conteúdo para oferecer busca, semântica e agentes. A privacidade vem da auto-hospedagem e da posse dos seus arquivos, não da criptografia ponta a ponta.

Mais sobre proteger o perímetro do agente: [Segurança e visibilidade](/docs/agents/security/).