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

# LLMs

> Como a Beehive disponibiliza contexto estruturado para agentes de IA e ferramentas como Cursor, Claude e ChatGPT.

## O que é o llms.txt?

O `llms.txt` é um arquivo de texto simples que fica na raiz de um site ou documentação e serve como **fonte de contexto para modelos de linguagem (LLMs)**. O conceito é análogo ao `robots.txt` para motores de busca — mas voltado para IAs.

Quando você cola a URL de um `llms.txt` em ferramentas como Cursor, Claude ou ChatGPT, o modelo passa a entender o produto, os endpoints, os padrões de autenticação e as regras de negócio daquela API **sem precisar vasculhar páginas de documentação separadas**.

<Info>
  O padrão foi proposto por [Jeremy Howard](https://llmstxt.org) e vem sendo adotado por fintechs, APIs e ferramentas developer-first ao redor do mundo.
</Info>

***

## Por que a Beehive tem um?

A API Beehive tem particularidades que costumam gerar erros em integrações assistidas por IA:

* Autenticação com esquema **Bearer + Basic** (base64 de `SECRET_KEY:x`)
* Valores sempre em **centavos** (ex.: `10000` = R\$ 100,00)
* Objeto `metadata` **obrigatório** em toda transação
* QR Code PIX: a API retorna o **texto**, não a imagem — a renderização é responsabilidade do cliente
* Tokenização de cartão **exclusivamente no front-end** (PCI-DSS)

Sem contexto adequado, agentes de IA cometem esses erros com frequência. O `llms.txt` resolve isso: ele reúne em um único arquivo todas as regras, exemplos e orientações específicas para quem está construindo ou gerando código de integração com a Beehive.

***

## Como usar

### No Cursor

Abra o chat do Cursor e cole o link do arquivo como contexto:

```
https://docs.beehivehub.io/llms.txt
```

A partir daí, o Cursor entende os endpoints, campos obrigatórios e padrões da API ao gerar ou revisar código.

### No Claude ou ChatGPT

Inicie sua conversa colando o conteúdo do arquivo ou fornecendo a URL diretamente:

```
Contexto da API: https://docs.beehivehub.io/llms.txt

Com base nisso, me ajude a criar uma transação PIX de R$ 50,00.
```

### Em qualquer agente ou MCP

O arquivo segue o padrão `llms.txt` — compatível com qualquer ferramenta que consuma contexto em texto plano.

***

## Acessar o arquivo

<Card title="llms.txt — Contexto para IAs" icon="robot" href="https://docs.beehivehub.io/llms.txt">
  Arquivo de contexto completo da API Beehive para uso em agentes de IA, Cursor, Claude e ChatGPT.
</Card>

***