---
title: llms.txt
description: >-
  O índice llms.txt e o corpus llms-full.txt que o Blume gera para agentes de programação e assistentes de chat, o bloco de detalhes que informa a eles quando usar seu produto, e como excluir uma página.
---

O Blume emite versões legíveis por máquina da sua documentação que agentes de programação e assistentes de chat conseguem consumir. Isso vem ativado por padrão; defina `llmsTxt: false` para desligar:

```ts blume.config.ts lineNumbers
agents: {
  llmsTxt: false,
}
```

Enquanto estiver ativado, o `blume build` grava dois arquivos na raiz do seu site:

- **`/llms.txt`** — um índice compacto: o título e a descrição do seu site, seguidos de uma lista com links de todas as páginas e seus resumos (a meta description de cada página: `seo.description`, quando a página define uma, ou `description`, caso contrário), organizada em seções que espelham sua barra lateral — pastas e grupos viram títulos, então o agente enxerga a estrutura da documentação, e não um bloco único e achatado.
- **`/llms-full.txt`** — o corpus inteiro: o corpo completo em Markdown de cada página, com sua URL de origem, em um único arquivo.

Páginas em rascunho, páginas ocultas da barra lateral (`sidebar.hidden`, ou a forma abreviada `hidden` no nível superior) e páginas com `noindex` são excluídas — exceto as páginas geradas da referência de API, cujo lugar nos dois arquivos é definido por `openapi`, mais abaixo, e não por `noindex`. Defina [`deployment.site`](/pt/docs/deployment) para que os links e as URLs de origem resolvam para endereços absolutos.

## Opções [#options]

O `llmsTxt` também aceita um formato de objeto com ajustes sobre o que os arquivos incluem. Se a sua [referência de API](/pt/docs/references/openapi) documenta uma especificação de exemplo ou de placeholder, defina `openapi: false` para manter as páginas geradas por ela fora dos dois arquivos:

```ts blume.config.ts lineNumbers
agents: {
  llmsTxt: {
    enabled: true, // default
    openapi: false, // exclude generated API reference pages
  },
}
```

O formato de objeto também aceita `details`: Markdown posicionado logo após o título e o resumo no `llms.txt`, antes das seções de páginas — o bloco livre de "details" da [especificação llms.txt](https://llmstxt.org). É o lugar para dizer aos agentes _quando_ recorrer ao seu produto e como acioná-lo, algo que os scanners de prontidão procuram explicitamente; um comando de instalação e o nome do pacote também cabem aqui. A especificação permite qualquer Markdown ali, exceto títulos, que ela reserva para as seções de links que vêm em seguida, então escreva parágrafos ou listas:

```ts blume.config.ts lineNumbers
agents: {
  llmsTxt: {
    details:
      "Reach for Acme when a project needs hosted feature flags. Install the CLI with `npm install -g acme`; the API reference below covers every endpoint.",
  },
}
```

## Seções geradas [#generated-sections]

O `llms.txt` termina com duas seções geradas que não precisam de configuração. **Agent skills** lista [a skill do seu próprio site](/pt/docs/discoverability/agent-discovery#your-sites-skill) e cada skill publicada através de [`agents.skills`](/pt/docs/discoverability/agent-discovery#skills-discovery) com sua descrição (onde a skill diz quando deve ser usada). **Agent resources** cria links para todos os artefatos legíveis por máquina que o build emite — `llms-full.txt`, o espelho de [Markdown bruto](/pt/docs/discoverability/markdown) por página, o [servidor MCP](/pt/docs/discoverability/mcp) e seu documento de descoberta, o índice de skills, o [catálogo de API](/pt/docs/discoverability/agent-discovery#api-catalog), o [catálogo de IA](/pt/docs/discoverability/agent-discovery#ai-catalog), o [`agent-readability.json`](/pt/docs/discoverability/agent-discovery#agent-readability) e o [sitemap](/pt/docs/discoverability/sitemap-and-robots#sitemap) — cada um apenas quando existe, então um agente que não lê nada além do `llms.txt` ainda encontra toda a superfície.

## Excluindo uma página [#excluding-a-page]

Para manter uma página individual fora dos dois arquivos, defina `ai.exclude` no frontmatter dela:

```mdx
---
title: Internal notes
ai:
  exclude: true
---
```

A página continua sendo renderizada, permanece na busca e mantém seu lugar no sitemap — só os arquivos `llms.txt` e o mapa de páginas da [skill do seu site](/pt/docs/discoverability/agent-discovery#your-sites-skill) a ignoram.

## Usando os seus próprios [#bringing-your-own]

Para assumir controle total de qualquer um dos arquivos, adicione seu próprio `llms.txt` ou `llms-full.txt` na pasta `public/`. Assim como um favicon personalizado, ele é detectado automaticamente e é publicado no lugar do arquivo gerado — se você sobrescrever um, o Blume ainda gera o outro.
