Guía de inicio rápido | Developer Docs

Esta guía te permite poner en marcha KLA Digital. Instalarás un SDK de telemetría nativo, registrarás un agente gobernado, realizarás una ejecución con puntos de control humanos y exportarás un paquete de evidencia sellado criptográficamente.

Ejecutar la CLI de KLA

La CLI de KLA se ejecuta actualmente desde este monorepo. Desde la raíz del repositorio, compílala con Node.js 20.x:

pnpm install --frozen-lockfile
pnpm kla --help
alias kla='pnpm --silent kla'

El wrapper del repositorio vuelve a compilar la CLI cuando un archivo fuente es más reciente que la salida generada.

Paso 1: Instala un SDK de telemetría

KLA se integra con frameworks estándar mediante instrumentación nativa de OpenTelemetry. Elige tu lenguaje:

Node.js

pnpm add @kla-digital/otel-node

Python

pip install kla-otel-python

ℹ️ Note

El SDK se engancha automáticamente a bibliotecas comunes como Express, FastAPI, LangChain y OpenAI, capturando los prompts de entrada, las restricciones del sistema, los costos de tokens y los parámetros de las herramientas.

Paso 2: Apunta OTLP hacia KLA

Configura las variables de entorno de tu servicio para enrutar los spans de telemetría a través del KLA Collector. Puedes obtener tu endpoint de API específico y tus tokens de tenant desde la KLA Console.

OTEL_SERVICE_NAME=claims-triage-agent
OTEL_EXPORTER_OTLP_ENDPOINT=https://api.kla.digital/collector
KLA_TENANT_ID=kpmg-reporting
KLA_API_KEY=kla_sec_prod_8f2d89a2
KLA_PII_MASK=true

💡 Tip

Establecer KLA_PII_MASK=true garantiza que cualquier cadena sensible, contraseña o dato personal se redacte antes de salir de tu contenedor de ejecución.

Paso 3: Registra tu agente

Registra una nueva declaración de agente enviando un manifiesto al KLA Control Plane. Esto define el nombre, la descripción, los parámetros y las listas de herramientas permitidas del agente:

curl -X POST https://api.kla.digital/execution/v1/agents \
  -H "Authorization: Bearer $KLA_API_KEY" \
  -H "x-kla-tenant-id: $KLA_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "claims-bot",
    "description": "Triages inbound customer claims with human-approval gates",
    "model": "gpt-4o-mini",
    "temperature": 0.2,
    "tools": ["search_claims_db", "process_refund"]
  }'

La respuesta del servidor devolverá un agentId estable (por ejemplo, agt_9f81a7) y un manifestHash compilado que representa el estado de tu configuración.

Paso 4: Inicia una ejecución gobernada

Inicia una nueva ejecución de flujo de trabajo enrutando tu solicitud de ejecución a través del KLA Engine. KLA evalúa las políticas activas en tiempo real. Si el prompt de entrada activa una regla de seguridad (por ejemplo, iniciar un reembolso superior a $1000), KLA pausa la ejecución y coloca la tarea en el Decision Desk para su revisión.

curl -X POST https://api.kla.digital/execution/v1/executions \
  -H "Authorization: Bearer $KLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agt_9f81a7",
    "input": { "prompt": "Process refund for claim #9921 for $1250.00" },
    "budgets": { "maxSteps": 50, "maxTokens": 20000, "maxCostUsd": 5 },
    "flags": { "euOnly": true }
  }'

Puedes escuchar las actualizaciones de ejecución y las decisiones con intervención humana suscribiéndote al flujo WebSocket en: wss://api.kla.digital/execution/ws

Paso 5: Exporta evidencia firmada

Una vez concluidas las ejecuciones, puedes descargar las hojas de evidencia utilizando la utilidad de línea de comandos kla. Estos paquetes contienen pruebas Merkle firmadas y entradas de auditoría que coinciden con las trazas exactas del flujo de trabajo.

# Exporta los últimos 30 días a un directorio local
kla evidence export --tenant $KLA_TENANT_ID --days 30 --out ./evidence

# Exporta un periodo exacto
kla evidence export --tenant $KLA_TENANT_ID \
  --start-date 2026-07-01 \
  --end-date 2026-07-31 \
  --out ./evidence

El Sealed Evidence Bundle resultante está listo para entregarse a los auditores o responsables de cumplimiento.