KLA Digital Logo
KLA Digital
Entwickler

KLA Digital in Minuten integrieren

Instrumentieren Sie KI-Traffic als OpenTelemetry-Traces, führen Sie gesteuerte Ausführungen durch und exportieren Sie Audit-Nachweise automatisch. Entwickelt für regulierte Teams, die schnell Agenten ausliefern.

SDK-first Telemetrie

Drop-in Node- und Python-OpenTelemetry-SDKs mit GenAI-Semantik.

Execution-API

Starten Sie Ausführungen, streamen Sie Fortschritt und verarbeiten Sie menschliche Genehmigungen.

Nachweis-Export

Erstellen Sie Annex IV und SOC 2-konforme Pakete aus Live-Traces.

5-10 Minuten

Schnellstart

Von null Instrumentierung zu gesteuerter Ausführung und Nachweis-Export.

1. Telemetrie-SDK installieren

Nutzen Sie unsere OpenTelemetry-SDKs, um GenAI-Spans automatisch zu senden. Wählen Sie Ihre Runtime:

INSTALL
# Node.js
pnpm add @kla-digital/otel-node

# Python
pip install kla-otel-python

Das SDK erkennt gängige Frameworks automatisch (Express, FastAPI, LangChain, OpenAI).

2. OTLP auf KLA verweisen

Konfigurieren Sie Ihren OTLP-Exporter, um Traces an den Collector Ihres Tenants zu senden. Sie erhalten den Endpunkt und API-Token in der Konsole.

.env
OTEL_SERVICE_NAME=claims-service
OTEL_EXPORTER_OTLP_ENDPOINT=https://<your-collector-endpoint>
KLA_TENANT_ID=<your-tenant-id>
KLA_PII_MASK=true

Setzen Sie `KLA_PII_MASK`, um standardmäßig sensible Werte in Traces zu vermeiden.

3. Agent registrieren

Agenten werden als Manifeste deklariert. Erstellen Sie einen über die Execution API:

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

Die Antwort enthält eine stabile `agentId` und einen unveränderlichen `manifestHash`.

4. Ausführung starten

Ausführungen sind dauerhafte Workflows mit Budgets und Policy-Checks.

curl
curl -X POST https://api.kla.local/execution/v1/executions \
  -H "Authorization: Bearer $KLA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "<agentId from step 3>",
    "input": { "prompt": "Summarise today\u0027s high-risk claims." },
    "budgets": { "maxSteps": 50, "maxTokens": 20000, "maxCostUsd": 5 },
    "flags": { "euOnly": true }
  }'

Streamen Sie den Fortschritt über WebSocket unter `wss://api.kla.local/execution/ws`.

5. Nachweise exportieren (Annex IV, SOC 2)

Das CLI lädt manipulationssichere Audit-Logs und generiert signierte Pakete, die für Regulierungsbehörden und Auditoren bereit sind.

kla
# Last 30 days as PDF
kla export evidence --tenant $KLA_TENANT_ID --days 30 --format pdf

# Filter by framework or controls
kla export evidence --tenant $KLA_TENANT_ID --frameworks "SOC 2 Type II" --format csv
Telemetrie

Offizielle SDKs

Sprachnative OpenTelemetry mit GenAI-Semantic-Conventions.

Node.js

Zero-Config-Auto-Instrumentierung für Express, tRPC, LangChain, OpenAI und mehr.

node
import '@kla-digital/otel-node';

Python

Drop-in FastAPI-Middleware und LangChain-Auto-Instrumentierung mit integrierter PII-Maskierung und Cost-Tracking.

python
import kla_otel_python