Schnelleinstieg | Developer Docs

Diese Anleitung bringt Sie mit KLA Digital schnell zum Laufen. Sie installieren ein natives Telemetrie-SDK, registrieren einen kontrollierten Agenten, führen eine Ausführung mit menschlichen Prüfpunkten durch und exportieren ein kryptografisch versiegeltes Nachweispaket.

Schritt 1: Ein Telemetrie-SDK installieren

KLA lässt sich über native OpenTelemetry-Instrumentierung in gängige Frameworks integrieren. Wählen Sie Ihre Sprache:

Node.js

pnpm add @kla-digital/otel-node

Python

pip install kla-otel-python

ℹ️ Note

Das SDK klinkt sich automatisch in gängige Bibliotheken wie Express, FastAPI, LangChain und OpenAI ein und erfasst dabei Eingabe-Prompts, Systemvorgaben, Token-Kosten und Tool-Parameter.

Schritt 2: OTLP auf KLA ausrichten

Konfigurieren Sie die Umgebungsvariablen Ihres Dienstes, um Telemetrie-Spans über den KLA Collector zu leiten. Ihren spezifischen API-Endpunkt und Ihre Tenant-Token können Sie in der KLA Console abrufen.

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

Wenn Sie `KLA_PII_MASK=true` setzen, stellen Sie sicher, dass sensible Zeichenketten, Passwörter oder persönliche Daten geschwärzt werden, bevor sie Ihren Ausführungscontainer verlassen.

Schritt 3: Ihren Agenten registrieren

Registrieren Sie eine neue Agentendeklaration, indem Sie ein Manifest an die KLA Control Plane senden. Damit definieren Sie Name, Beschreibung, Parameter und die Liste der zugelassenen Tools des Agenten:

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

Die Serverantwort liefert eine stabile agentId (z. B. agt_9f81a7) sowie einen kompilierten manifestHash, der den Zustand Ihrer Konfiguration repräsentiert.

Schritt 4: Eine kontrollierte Ausführung auslösen

Starten Sie einen neuen Workflow-Lauf, indem Sie Ihre Ausführungsanfrage über die KLA Engine leiten. KLA wertet aktive Policies in Echtzeit aus. Löst der Eingabe-Prompt eine Sicherheitsregel aus (z. B. das Auslösen einer Rückerstattung über 1000 USD), pausiert KLA die Ausführung und legt die Aufgabe zur Prüfung auf den Decision Desk.

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

Ausführungsaktualisierungen und Human-in-the-Loop-Entscheidungen können Sie verfolgen, indem Sie den WebSocket-Stream abonnieren unter: wss://api.kla.digital/execution/ws

Schritt 5: Signierte Nachweise exportieren

Nach Abschluss von Ausführungen können Sie Nachweisblätter mit dem Kommandozeilenwerkzeug kla herunterladen. Diese Pakete enthalten signierte Merkle-Proofs und Audit-Einträge, die exakt den Traces des Workflows entsprechen.

# Die letzten 30 Tage als PDF exportieren
kla export evidence --tenant $KLA_TENANT_ID --days 30 --format pdf

# Nach einem bestimmten Compliance-Framework filtern
kla export evidence --tenant $KLA_TENANT_ID --frameworks "SOC 2 Type II" --format csv

Das resultierende Sealed Evidence Bundle ist bereit zur Übergabe an Auditoren oder Compliance-Verantwortliche.