Outil

Une invocation d’outil. Émet un span execute_tool contenant le nom de l’outil, les arguments encodés en JSON, l’ID de l’appel d’outil et le résultat. Créé par weave.startTool() (ou turn.startTool() ou llm.startTool()) et terminé avec end(). Attribuez result avant d’appeler end() pour enregistrer la sortie de l’outil dans le span. Défini dans : src/genai/tool.ts:43

Exemple

const tool = weave.startTool({
  name: tc.function.name,
  args: tc.function.arguments,
  toolCallId: tc.id,
});
try {
  tool.result = await wikipediaSearch(JSON.parse(tc.function.arguments));
} finally {
  tool.end();
}

Hérite de

SpanBase

Propriétés

args

readonly args : string

Défini dans : src/genai/tool.ts:52

nom

readonly nom: string

Défini dans : src/genai/tool.ts:51

result

facultatif result: string

Sortie de l’outil sous forme de chaîne. Enregistré dans gen_ai.tool.call.result lors de end(). Défini dans : src/genai/tool.ts:47

toolCallId

readonly toolCallId: string

Défini dans : src/genai/tool.ts:53

Méthodes

addEvent()

Obsolète. Enregistrez plutôt ces données avec 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 non associés à un span, 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. Défini dans : src/genai/spanBase.ts:82

Paramètres

nom

string

attribut ?

Attributes

startTime ?

TimeInput

Renvoie

this

Exemple

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

Hérité de

SpanBase.addEvent

end()

end(opts?) : void

Envoyez result au span et fermez-le. Idempotent. Transmettez error pour marquer le span comme ayant échoué ; transmettez endTime pour antidater la fermeture. Défini dans : src/genai/tool.ts:87

Paramètres

opts?

SpanEndOptions

Renvoie

void

setAttributes()

setAttributes(attributes) : this

Définit simultanément plusieurs attributs sur le span. Émet un avertissement et ne fait rien après end(). Correspond à Span.setAttributes d’OTel (ainsi qu’à set_attributes du SDK Python). Défini dans : src/genai/spanBase.ts:63

Paramètres

attributs

Attributes

Renvoie

this

Exemple

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

Hérité de

SpanBase.setAttributes

W&B Models

W&B Weave

Serverless Inference

Serverless Training

Exemple

Hérite de

Propriétés

args

nom

result

toolCallId

Méthodes

addEvent()

Paramètres

nom

attribut ?

startTime ?

Renvoie

Exemple

Hérité de

end()

Paramètres

opts?

Renvoie

setAttributes()

Paramètres

attributs

Renvoie

Exemple

Hérité de

​Exemple

​Hérite de

​Propriétés

​args

​nom

​result

​toolCallId

​Méthodes

​addEvent()

​Paramètres

nom

attribut ?

startTime ?

​Renvoie

​Exemple

​Hérité de

​end()

​Paramètres

opts?

​Renvoie

​setAttributes()

​Paramètres

attributs

​Renvoie

​Exemple

​Hérité de

Exemple

Hérite de

Propriétés

args

nom

result

toolCallId

Méthodes

addEvent()

Paramètres

Renvoie

Exemple

Hérité de

end()

Paramètres

Renvoie

setAttributes()

Paramètres

Renvoie

Exemple

Hérité de