Guide de démarrage rapide | Developer Docs

Ce guide vous permet de prendre en main KLA Digital. Vous allez installer un SDK de télémétrie natif, enregistrer un agent gouverné, lancer une exécution avec point de contrôle humain, puis exporter un lot de preuves scellé cryptographiquement.

Étape 1 : installer un SDK de télémétrie

KLA s'intègre aux frameworks standards grâce à une instrumentation OpenTelemetry native. Choisissez votre langage :

Node.js

pnpm add @kla-digital/otel-node

Python

pip install kla-otel-python

ℹ️ Note

Le SDK se branche automatiquement sur les bibliothèques courantes telles qu'Express, FastAPI, LangChain et OpenAI, en capturant les prompts d'entrée, les contraintes système, les coûts en tokens et les paramètres des outils.

Étape 2 : router OTLP vers KLA

Configurez les variables d'environnement de votre service pour acheminer les spans de télémétrie via le KLA Collector. Vous pouvez récupérer votre endpoint API spécifique et vos jetons de tenant depuis 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

Définir `KLA_PII_MASK=true` garantit que toute chaîne sensible, tout mot de passe ou toute donnée personnelle est masqué avant de quitter votre conteneur d'exécution.

Étape 3 : enregistrer votre agent

Enregistrez une nouvelle déclaration d'agent en envoyant un manifeste au KLA Control Plane. Celui-ci définit le nom de l'agent, sa description, ses paramètres et la liste des outils autorisés :

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 réponse du serveur renverra un agentId stable (par exemple agt_9f81a7) ainsi qu'un manifestHash compilé représentant l'état de votre configuration.

Étape 4 : déclencher une exécution gouvernée

Lancez une nouvelle exécution de workflow en acheminant votre requête d'exécution via le KLA Engine. KLA évalue les politiques actives en temps réel. Si le prompt d'entrée déclenche une règle de sécurité (par exemple, l'initiation d'un remboursement supérieur à 1000 $), KLA met l'exécution en pause et place la tâche sur le Decision Desk pour révision.

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 }
  }'

Vous pouvez suivre les mises à jour d'exécution et les décisions avec intervention humaine en vous abonnant au flux WebSocket à l'adresse : wss://api.kla.digital/execution/ws

Étape 5 : exporter des preuves signées

Une fois les exécutions terminées, vous pouvez télécharger les feuilles de preuves à l'aide de l'utilitaire en ligne de commande kla. Ces paquets contiennent des Merkle proofs signées et des entrées d'audit correspondant exactement aux traces du workflow.

# Exporter les 30 derniers jours au format PDF
kla export evidence --tenant $KLA_TENANT_ID --days 30 --format pdf

# Filtrer selon un référentiel de conformité spécifique
kla export evidence --tenant $KLA_TENANT_ID --frameworks "SOC 2 Type II" --format csv

Le Sealed Evidence Bundle ainsi obtenu est prêt à être remis aux auditeurs ou aux responsables de la conformité.