> ## 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.

# Axiom

> Deixe agents explorarem seus logs e eventos no Axiom com queries APL read-only

Conecte o Axiom e seus agents passam a vasculhar logs e eventos sem que ninguém precise escrever uma query na mão: encontrar os erros por trás de um incidente, quantificar a frequência de um problema, levantar os números para um status report.

**Esta integração é somente leitura.** Agents listam datasets, inspecionam fields e executam queries APL — nunca ingerem, modificam ou apagam dados.

## O que os agents podem fazer

| Capacidade           | Detalhes                                                              |
| -------------------- | --------------------------------------------------------------------- |
| Listar datasets      | Descobrir o que existe no workspace antes de consultar.               |
| Inspecionar fields   | Nomes e tipos dos fields, para queries escritas contra o schema real. |
| Executar queries APL | Consultas read-only com limites de resultado sensatos.                |

## Experimente perguntar

* *"Quantos erros 5xx a API registrou nas últimas 24 horas?"*
* *"Quais são as mensagens de erro mais comuns no dataset do worker nesta semana?"*
* *"Mostre a tendência de latência das requisições de checkout desde segunda-feira."*
* *"Aconteceu algo fora do normal nos logs por volta das 14:30 UTC de ontem?"*
* *"Quais datasets temos, e quão recentes são os dados de cada um?"*

## Conectar o Axiom

<Steps>
  <Step title="Crie um API token no Axiom">
    Nas configurações do seu workspace Axiom, crie um **API token avançado** somente com o que os agents precisam:

    * listar datasets;
    * ler fields de datasets;
    * executar queries APL.

    Restrinja o token aos datasets que os agents podem consultar. O token começa com `xaat-`.
  </Step>

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

  <Step title="Cole o token">
    Mantenha o edge padrão, a menos que seu administrador do Axiom tenha indicado um edge regional (veja abaixo), cole o token e selecione **Conectar Axiom**. A Leme valida o token listando datasets antes de salvar.
  </Step>

  <Step title="Habilite nos seus agents">
    Vincule a conexão aos agents que devem usá-la.
  </Step>
</Steps>

<Note>
  Use um **API token** do Axiom, não um Personal Access Token. API tokens permitem menor privilégio; PATs dão controle amplo demais sobre a conta.
</Note>

O Axiom é uma conexão **compartilhada**: todos os agents habilitados consultam pelo mesmo token, então as restrições de dataset do token são a fronteira para todos eles.

## Configuração de edge

A maioria dos times mantém o edge padrão `api`. Mude apenas se o administrador do Axiom disser que as queries devem usar um edge regional:

| Edge                    | Use quando                                                |
| ----------------------- | --------------------------------------------------------- |
| `api`                   | Você não tem certeza, ou seu workspace usa o edge padrão. |
| `us-east-1.aws.edge`    | Seu administrador do Axiom indicou o edge US East 1.      |
| `eu-central-1.aws.edge` | Seu administrador do Axiom indicou o edge EU Central 1.   |

## Permissões

| Ação                                              | Categoria | Padrão   |
| ------------------------------------------------- | --------- | -------- |
| Listar datasets, ler fields, executar queries APL | Leitura   | Permitir |

Nada mais a configurar — a integração não tem ações de escrita. O escopo de acesso é definido do lado do Axiom, pelas restrições de dataset do token. Veja [Permissões e aprovações](/pt-BR/permissions) para o modelo geral.

## Notas de segurança

O token é armazenado criptografado e nunca é exibido de novo após a configuração. Rotacione-o no Axiom se ele puder ter sido exposto, quando o dono sair da empresa ou quando seu modelo de permissões mudar — e reconecte na Leme com o novo token.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O token é rejeitado antes de chegar ao Axiom">
    Verifique o formato: API tokens do Axiom começam com `xaat-`. Personal Access Tokens não são aceitos.
  </Accordion>

  <Accordion title="A configuração falha na validação">
    O token não consegue listar datasets. Recrie-o com permissão de leitura de datasets, ou use um token com escopo suficiente.
  </Accordion>

  <Accordion title="Queries falham depois de conectar">
    Ou o edge não corresponde ao seu workspace — confirme com o administrador do Axiom e reconecte — ou o token não tem permissão para consultar aquele dataset.
  </Accordion>

  <Accordion title="O agent não enxerga um dataset">
    O token está restrito a datasets específicos e aquele não está incluído. Amplie o acesso a datasets do token no Axiom.
  </Accordion>
</AccordionGroup>