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.

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-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 como PDF
kla export evidence --tenant $KLA_TENANT_ID --days 30 --format pdf

# Filtra por un marco de cumplimiento específico
kla export evidence --tenant $KLA_TENANT_ID --frameworks "SOC 2 Type II" --format csv

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