Turn - Weights & Biases Documentation

Un appel d’agent. Encapsule généralement le traitement nécessaire pour répondre à un seul message utilisateur. Émet un span invoke_agent et sert de racine à la trace de ce tour de conversation : il est toujours démarré sous ROOT_CONTEXT, afin de n’hériter jamais accidentellement d’un parent provenant d’une autre bibliothèque instrumentée avec OTel. Créé par weave.startTurn() (ou conversation.startTurn()) et terminé avec end(). Un seul tour de conversation peut être actif dans une chaîne asynchrone. Les enfants (LLM, Tool, SubAgent) s’y rattachent via les méthodes startLLM, startTool et startSubagent.

Exemples

const turn = weave.startTurn();

try {
  const llm = turn.startLLM({model: 'gpt-4o', providerName: 'openai'});
  // ...
  llm.end();
} finally {
  turn.end();
}

const turn = weave.startTurn({
  model: 'gpt-4o',
  agentName: 'research-bot',
  agentId: 'research-bot-prod',
  agentDescription: 'Looks up facts on Wikipedia.',
  agentVersion: '1.4.2',
  userMessage: 'What is the weather in Tokyo?',
  systemInstructions: ['You are a helpful weather bot.'],
  startTime: new Date('2026-05-29T10:00:00.000Z'),
});

try {
  const llm = turn.startLLM({model: 'gpt-4o', providerName: 'openai'});
  // ...
  llm.end();
} finally {
  turn.end();
}

Hérite de

SpanBase

Accesseurs

nomAgent

Signature d’obtention

get agentName(): string

Renvoie

string

model

Signature d’obtention

get model(): string

Renvoie

string

Méthodes

addEvent()

Obsolète. Enregistrez plutôt ces données via setAttributes. OpenTelemetry abandonne progressivement l’API d’événements de span (Span.addEvent). Cette méthode fonctionne toujours et les données d’événements de span existantes restent valides. Voir https://opentelemetry.io/blog/2026/deprecating-span-events/

addEvent(name, attributes?, startTime?): this

Ajoute un événement nommé au span. Utile pour marquer des moments ne correspondant pas à des spans, tels que la compaction du contexte, la détection de boucles d’outils ou le déclenchement de guardrails. Émet un avertissement et ne fait rien après end(). Reproduit Span.addEvent d’OTel.

Paramètres

string

requis

Attributes

TimeInput

Renvoie

this

Exemple

span.addEvent('context_compacted', {removedMessages: 12});

Hérité de

SpanBase.addEvent

end()

end(opts?) : void

Lisez les valeurs actuelles des champs (afin de refléter les modifications apportées via record() depuis start) et fermez le span. Cette opération est idempotente. Transmettez error pour le marquer comme ayant échoué ; transmettez endTime pour antidater sa fermeture.

Paramètres

object

Masquer propriétés

TimeInput

Error

Renvoie

void

record()

record(opts) : this

Définit en bloc n’importe quel sous-ensemble de champs modifiables. Remplace les valeurs existantes (sans les fusionner). Utile pour tout attribuer en une seule fois après le retour d’un appel de fournisseur.

Paramètres

object

requis

Masquer propriétés

string

Message[]

Voir Message.

string

Message[]

Voir Message.

string[]

Renvoie

this

setAttribute()

Obsolète. Utilisez plutôt setAttributes, qui correspond à set_attributes du SDK Python et à Span.setAttributes d’OTel. Conservée comme simple alias pour que les appels existants avec un seul attribut continuent de fonctionner. Seul tour de conversation propose cette méthode ; les autres émetteurs n’ont jamais eu de forme au singulier.

setAttribute(key, value) : this

Paramètres

string

requis

AttributeValue

requis

Renvoie

this

setAttributes()

setAttributes(attributes) : this

Définit plusieurs attributs sur le span à la fois. Émet un avertissement et ne fait rien après end(). Reproduit le comportement de Span.setAttributes d’OTel (et de set_attributes du SDK Python).

Paramètres

Attributes

requis

Renvoie

this

Exemple

span.setAttributes({'weave.tag': 'prod', 'gen_ai.response.id': id});

Hérité de

SpanBase.setAttributes

startLLM()

startLLM(opts): LLM

Démarre un span LLM enfant dans ce tour de conversation.

Paramètres

LLMInit

requis

Voir LLMInit.

Renvoie

LLM

startSubagent()

startSubagent(opts) : SubAgent

Démarre un span SubAgent enfant dans le cadre de ce tour de conversation.

Paramètres

SubAgentInit

requis

Voir SubAgentInit.

Renvoie

SubAgent

startTool()

startTool(opts) : Tool

Démarre un span Tool enfant dans ce tour de conversation.

Paramètres

ToolInit

requis

Voir ToolInit.

Renvoie

Tool

​Exemples

​Hérite de

​Accesseurs

​nomAgent

​Signature d’obtention

Renvoie

​model

​Signature d’obtention

Renvoie

​Méthodes

​addEvent()

​Paramètres

​Renvoie

​Exemple

​Hérité de

​end()

​Paramètres

​Renvoie

​record()

​Paramètres

​Renvoie

​setAttribute()

​Paramètres

​Renvoie

​setAttributes()

​Paramètres

​Renvoie

​Exemple

​Hérité de

​startLLM()

​Paramètres

​Renvoie

​startSubagent()

​Paramètres

​Renvoie

​startTool()

​Paramètres

​Renvoie

Exemples

Hérite de

Accesseurs

nomAgent

Signature d’obtention

model

Signature d’obtention

Méthodes

addEvent()

Paramètres

Renvoie

Exemple

Hérité de

end()

Paramètres

Renvoie

record()

Paramètres

Renvoie

setAttribute()

Paramètres

Renvoie

setAttributes()

Paramètres

Renvoie

Exemple

Hérité de

startLLM()

Paramètres

Renvoie

startSubagent()

Paramètres

Renvoie

startTool()

Paramètres

Renvoie