Trajekt enregistre chaque étape de chaque run — raisonnement, appels d’outils, entrées et sorties, tokens, latence, coût — pour que, le jour où un agent déraille en production, vous puissiez rejouer exactement ce qui s’est passé.
npm i @trajekt-ai/coreParcourez un run comme une timeline. Chaque étape montre le prompt, le raisonnement du modèle, les arguments exacts passés à l’outil et ce qu’il a renvoyé.
{
"project": "PAY",
"summary": "NPE in checkout discount",
"priority": "High"
}Tokens, latence et coût sont détaillés étape par étape. Relances, appels d’outils répétés et boucles sont signalés sur la timeline : la partie coûteuse saute aux yeux.
Mettez deux runs côte à côte, alignés étape par étape. Étapes ajoutées, mauvais outils et résultats différents ressortent, à côté de la configuration qui a changé entre les deux.
Chargez un exemple — ou votre propre export — et rejouez-le étape par étape, boucles, relances et échecs signalés.
Export de trace Langfuse, OTLP/JSON ou résultat du Vercel AI SDK — déposez-le n’importe où sur ce panneau. Il est lu dans votre navigateur par @trajekt-ai/core ; rien n’est envoyé.
#7 et #9 répètent un appel précédent avec les mêmes arguments. 2 relances après un échec. Le run a échoué.
{
"query": "checkout/discount.ts",
"scope": "blobs"
}chemin d’outils : sentry.getIssue → gitlab.searchCode ×3 → gitlab.readFile → jira.createIssue → gitlab.createMergeRequest → slack.postMessage
Fichiers d’exemple : otlp-sentry-triage.json · langfuse-support-bot.json · ai-sdk-trip-planner.json
Branchez n’importe quel exporteur OpenTelemetry sur Trajekt. Les spans qui suivent les conventions sémantiques GenAI ou la télémétrie du Vercel AI SDK sont compris tels quels.
Chaque run devient une trajectoire : étapes, arguments et résultats d’outils, tokens, latence et coût, regroupés par agent et par version.
Ouvrez n’importe quel run sur une timeline, comparez-le à un autre et voyez quand une nouvelle version se met à boucler, à échouer ou à coûter plus cher.
// instrumentation.ts — OpenTelemetry standard, rien de propriétaire
import { NodeSDK } from '@opentelemetry/sdk-node';
import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
new NodeSDK({
serviceName: 'sentry-triage',
traceExporter: new OTLPTraceExporter({
url: 'http://localhost:3000/v1/traces',
headers: { Authorization: `Bearer ${process.env.TRAJEKT_API_KEY}` },
}),
}).start();
// Avec le Vercel AI SDK, activez la télémétrie à chaque appel :
await generateText({
model, prompt, tools,
experimental_telemetry: { isEnabled: true, functionId: 'sentry-triage' },
});Vous avez déjà des traces ? @trajekt-ai/core les lit dans votre propre code et vos tests :
import { normalize, computeMetrics } from '@trajekt-ai/core';
// Un export Langfuse, des spans OTLP/JSON ou un résultat AI SDK
const run = normalize(trace);
const { status, costUsd, redundantToolCalls, retryCount } = computeMetrics(run);Les prompts et les résultats d’outils contiennent souvent des données clients. Trajekt est open source et tourne avec un seul fichier Docker Compose, à côté de vos agents.
$ git clone https://github.com/LeoLR/trajekt.git
$ cd trajekt
$ docker compose up -d
✓ Trajekt tourne sur http://localhost:3000