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

> Permite que los agents exploren tus logs y eventos en Axiom con queries APL de solo lectura

Conecta Axiom y tus agents podrán buscar en tus logs y eventos sin que nadie escriba una query a mano: encontrar los errores detrás de un incidente, cuantificar la frecuencia de un problema, sacar los números para un reporte de estado.

**Esta integración es de solo lectura.** Los agents listan datasets, inspeccionan fields y ejecutan queries APL — nunca ingieren, modifican ni borran datos.

## Qué pueden hacer los agents

| Capacidad            | Detalles                                                                     |
| -------------------- | ---------------------------------------------------------------------------- |
| Listar datasets      | Descubrir qué hay en el workspace antes de consultar.                        |
| Inspeccionar fields  | Nombres y tipos de los fields, para escribir queries contra el esquema real. |
| Ejecutar queries APL | Consultas de solo lectura con límites de resultados razonables.              |

## Prueba preguntar

* *"¿Cuántos errores 5xx registró la API en las últimas 24 horas?"*
* *"¿Cuáles son los mensajes de error más comunes en el dataset del worker esta semana?"*
* *"Muéstrame la tendencia de latencia de las solicitudes de checkout desde el lunes."*
* *"¿Pasó algo inusual en los logs alrededor de las 14:30 UTC de ayer?"*
* *"¿Qué datasets tenemos y qué tan recientes son sus datos?"*

## Conectar Axiom

<Steps>
  <Step title="Crea un API token en Axiom">
    En la configuración de tu workspace de Axiom, crea un **API token avanzado** solo con lo que los agents necesitan:

    * listar datasets;
    * leer fields de datasets;
    * ejecutar queries APL.

    Restringe el token a los datasets que los agents pueden consultar. El token empieza con `xaat-`.
  </Step>

  <Step title="Abre Integraciones">
    En el panel de Leme, ve a **Integraciones** y selecciona **Axiom**.
  </Step>

  <Step title="Pega el token">
    Mantén el edge por defecto, salvo que tu administrador de Axiom te haya indicado un edge regional (ver abajo), pega el token y selecciona **Conectar Axiom**. Leme valida el token listando datasets antes de guardarlo.
  </Step>

  <Step title="Habilítalo en tus agents">
    Vincula la conexión a los agents que deban usarla.
  </Step>
</Steps>

<Note>
  Usa un **API token** de Axiom, no un Personal Access Token. Los API tokens permiten mínimo privilegio; los PATs otorgan control demasiado amplio sobre la cuenta.
</Note>

Axiom es una conexión **compartida**: todos los agents habilitados consultan con el mismo token, así que las restricciones de datasets del token son el límite para todos.

## Configuración de edge

La mayoría de los equipos mantiene el edge por defecto `api`. Cámbialo solo si el administrador de Axiom indica que las queries deben usar un edge regional:

| Edge                    | Úsalo cuando                                              |
| ----------------------- | --------------------------------------------------------- |
| `api`                   | No estás seguro, o tu workspace usa el edge por defecto.  |
| `us-east-1.aws.edge`    | Tu administrador de Axiom te indicó el edge US East 1.    |
| `eu-central-1.aws.edge` | Tu administrador de Axiom te indicó el edge EU Central 1. |

## Permisos

| Acción                                             | Categoría | Por defecto |
| -------------------------------------------------- | --------- | ----------- |
| Listar datasets, leer fields, ejecutar queries APL | Lectura   | Allow       |

No hay nada más que configurar — la integración no tiene acciones de escritura. El alcance del acceso se define del lado de Axiom, con las restricciones de datasets del token. Consulta [Permisos y aprobaciones](/es/permissions) para el modelo general.

## Notas de seguridad

El token se guarda cifrado y no vuelve a mostrarse después de la configuración. Rótalo en Axiom si pudo quedar expuesto, cuando su dueño deje la empresa o cuando cambie tu modelo de permisos — y reconecta en Leme con el token nuevo.

## Solución de problemas

<AccordionGroup>
  <Accordion title="El token se rechaza antes de llegar a Axiom">
    Revisa el formato: los API tokens de Axiom empiezan con `xaat-`. Los Personal Access Tokens no se aceptan.
  </Accordion>

  <Accordion title="La configuración falla durante la validación">
    El token no puede listar datasets. Créalo de nuevo con permiso de lectura de datasets, o usa un token con alcance suficiente.
  </Accordion>

  <Accordion title="Las queries fallan después de conectar">
    O el edge no corresponde a tu workspace — confírmalo con el administrador de Axiom y reconecta — o el token no tiene permiso para consultar ese dataset.
  </Accordion>

  <Accordion title="El agent no ve un dataset">
    El token está restringido a datasets específicos y ese no está incluido. Amplía el acceso a datasets del token en Axiom.
  </Accordion>
</AccordionGroup>