Évaluez les traces enregistrées avec OpenTelemetry.

Envoyez à Mibo les exécutions enregistrées de votre application via OpenTelemetry. Évaluez les réponses et les actions de chaque trace selon les contrôles que vous configurez.

Commencer gratuitement Explorer les cas de test

Connectez-vous avec OTLP sur HTTP

Envoyez vos traces directement à Mibo, ou gardez votre backend actuel, comme Langfuse, Datadog ou LangSmith, et ajoutez Mibo via un Collector. Les exemples ci-dessous montrent les deux configurations.

Mibo uniquementPlusieurs destinations

Envoyez les traces directement de votre application instrumentée vers Mibo.

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.mibo-ai.com/public/traces
export OTEL_EXPORTER_OTLP_TRACES_HEADERS='x-api-key=<YOUR_API_KEY>'
export OTEL_SERVICE_NAME='your-service-name'

Envoyez les traces à un OpenTelemetry Collector et configurez-le pour les transmettre à Mibo et à votre destination actuelle.

Exportateur de l’application

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://127.0.0.1:4318/v1/traces
export OTEL_SERVICE_NAME='your-service-name'

Configuration du Collector

receivers:
  otlp:
    protocols:
      http:
        endpoint: 127.0.0.1:4318
exporters:
  otlp_http/mibo:
    traces_endpoint: https://api.mibo-ai.com/public/traces
    headers:
      x-api-key: ${env:MIBO_API_KEY}
  otlp_http/other:
    traces_endpoint: '<YOUR_OTHER_OTLP_HTTP_TRACES_ENDPOINT>'
service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [otlp_http/mibo, otlp_http/other]

Définissez MIBO_API_KEY dans l’environnement du Collector. L’autre destination peut nécessiter ses propres identifiants. Avec 127.0.0.1, l’application et le Collector doivent partager le même espace de noms réseau. Adaptez les en-têtes de l’exportateur au Collector ; les variables d’endpoint acceptent une URL, pas une liste séparée par des virgules.

Vous pouvez aussi configurer plusieurs exportateurs dans votre SDK.

Utilisez OTLP sur HTTP avec protobuf (recommandé) ou JSON. Remplacez le texte de la clé API avant l’envoi. La documentation détaille la configuration de chaque SDK.

Exemples par framework

Branchez sur Mibo l’instrumentation que vous avez déjà. Chaque exemple définit l’URL complète des traces, votre clé API et le nom du service.

Vercel AI SDK 7OpenLLMetry PythonOpenLLMetry TypeScript

Avec l’AI SDK 7, enregistrez l’intégration OpenTelemetry de @ai-sdk/otel, puis définissez telemetry pour chaque appel. L’exportateur lit l’URL des traces, la clé et le nom du service dans l’environnement.

Variables d’environnement

export OTEL_SERVICE_NAME=your-service-name
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.mibo-ai.com/public/traces
export OTEL_EXPORTER_OTLP_TRACES_HEADERS=x-api-key=<YOUR_API_KEY>
export OTEL_METRICS_EXPORTER=none
export OTEL_LOGS_EXPORTER=none

import { OpenTelemetry } from "@ai-sdk/otel";
import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
import { NodeSDK } from "@opentelemetry/sdk-node";
import { generateText, registerTelemetry } from "ai";

const sdk = new NodeSDK({ traceExporter: new OTLPTraceExporter() });
sdk.start();
registerTelemetry(new OpenTelemetry({ agentSpanName: "functionId" }));

const { text } = await generateText({
  model,
  prompt,
  telemetry: { functionId: "support-agent" },
});
await sdk.shutdown();

L’AI SDK 6 et l’intégration LegacyOpenTelemetry n’émettent que des attributs ai.*. Mibo ne peut contrôler ces traces que sur la durée et les tokens.

Passez un exportateur OTLP HTTP à Traceloop.init. app_name devient le nom du service. Les applications LangChain et LangGraph utilisent la même configuration : OpenLLMetry instrumente LangChain.

import os
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from traceloop.sdk import Traceloop

Traceloop.init(
    app_name="your-service-name",
    exporter=OTLPSpanExporter(
        endpoint="https://api.mibo-ai.com/public/traces",
        headers={"x-api-key": os.environ["MIBO_API_KEY"]},
    ),
)

Gardez l’enregistrement du contenu actif : TRACELOOP_TRACE_CONTENT=false supprime l’entrée et la réponse dont Mibo a besoin. Les anciennes versions écrivent gen_ai.prompt.0.content et gen_ai.completion.0.content, que Mibo ne lit pas.

Passez un exportateur OTLP à initialize. appName devient le nom du service. Installez l’exportateur de la même lignée OpenTelemetry que le SDK, comme @0.203 pour le SDK 0.27.

import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
import * as traceloop from "@traceloop/node-server-sdk";
import OpenAI from "openai";

traceloop.initialize({
  appName: "your-service-name",
  exporter: new OTLPTraceExporter({
    url: "https://api.mibo-ai.com/public/traces",
    headers: { "x-api-key": process.env.MIBO_API_KEY || "" },
  }),
  instrumentModules: { openAI: OpenAI },
});

Utilisez l’URL complète des traces

Les exportateurs ajoutent /v1/traces uniquement à la variable générique OTEL_EXPORTER_OTLP_ENDPOINT. Définissez OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ou l’option d’URL de l’exportateur.

Attributs lus par Mibo

Les contrôles node_call sont comparés aux noms de spans. Ceux de la réponse et des appels d’outils lisent gen_ai.output.messages ou gen_ai.response.text, et gen_ai.tool.name.

Autres instrumentations GenAI

Leur documentation enregistre le contenu avec OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental et OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span_only. Mibo ne les a pas vérifiées de bout en bout.

Moins de 10 Mo par requête

Réduisez la taille des lots si une requête est refusée parce qu’elle est trop volumineuse.

De la trace à l’évaluation

Envoyez une trace

Exportez une exécution en OTLP/HTTP protobuf ou JSON. Incluez la réponse et les actions nécessaires à vos contrôles.

Créez un brouillon avec l’IA

Sélectionnez une trace terminée. L’IA crée un brouillon à partir des éléments disponibles ; vérifiez et enregistrez les contrôles proposés.

Évaluez les traces suivantes

Envoyez d’autres traces et examinez les résultats de vos contrôles configurés.