instrumentOpenAIAgents

instrumentOpenAIAgents(): Promise<boolean>

Enregistre manuellement le traçage Weave auprès d’OpenAI Agents si le package est disponible. Remarque : en règle générale, vous n’avez pas besoin d’appeler cette fonction ! OpenAI Agents est automatiquement instrumenté via les hooks du chargeur de modules lorsque vous importez Weave. Cette fonction est fournie pour les cas limites où l’instrumentation automatique ne fonctionne pas (par exemple, avec des importations dynamiques ou des bundlers qui contournent les hooks). Cette fonction tente d’importer dynamiquement @openai/agents depuis le répertoire node_modules de l’application appelante et enregistre un TracingProcessor. Si le package n’est pas installé, elle renvoie false sans lever d’erreur.

Renvoie

Promise<boolean> Promise<boolean> - true si l’enregistrement a réussi, false si @openai/agents n’est pas disponible

Exemples

// ✅ Recommandé : importez simplement Weave, l’instrumentation est automatique !
import * as weave from 'weave';
await weave.init('my-project');

// OpenAI Agents est déjà instrumenté au moyen de hooks : aucune configuration manuelle n’est requise
import { Agent } from '@openai/agents';
const agent = new Agent({ ... });
await agent.run(input); // Tracé automatiquement dans Weave

// ⚠️ Uniquement nécessaire dans les cas limites où les hooks automatiques ne fonctionnent pas
import { instrumentOpenAIAgents } from 'weave';

const registered = await instrumentOpenAIAgents();
if (!registered) {
  console.log('OpenAI Agents not found - install @openai/agents to enable tracing');
}

Remarques

Fonctionnement de l’instrumentation automatique : lorsque vous importez Weave, celui-ci enregistre des hooks de chargeur de modules via addCJSInstrumentation() et addESMInstrumentation(). Lorsque votre code importe ensuite @openai/agents, ces hooks interceptent l’importation et appliquent automatiquement un patch au module pour ajouter le traçage Weave. Tout se fait de manière transparente : vous n’avez rien à faire ! Quand utiliser cette fonction : utilisez-la uniquement si l’instrumentation automatique échoue, par exemple dans les cas suivants :

Vous utilisez des importations dynamiques qui contournent les hooks de modules
Votre bundler ne prend pas en charge import-in-the-middle
Vous avez besoin de contrôler explicitement le moment où l’instrumentation a lieu

Alternative pour une logique de processeur personnalisée : si vous avez besoin d’un comportement de traçage personnalisé, utilisez createOpenAIAgentsTracingProcessor() et enregistrez-le manuellement :

import { addTraceProcessor } from '@openai/agents';
import { createOpenAIAgentsTracingProcessor } from 'weave';

const processor = createOpenAIAgentsTracingProcessor();
addTraceProcessor(processor);

Weights & Biases

Guides

Intégrations

Référence

Assistance

Renvoie

Exemples

Remarques

​Renvoie

​Exemples

​Remarques

Renvoie

Exemples

Remarques