Tool

Une invocation d’outil. Émet un span execute_tool contenant le nom de l’outil, les arguments, l’ID de l’appel d’outil et le résultat. Les arguments et les résultats de type chaîne sont enregistrés tels quels ; les autres valeurs JSON sont sérialisées. Créée par weave.startTool() (ou turn.startTool(), ou llm.startTool()) et terminée par end(), qui accepte le résultat et des métadonnées d’erreur facultatives.

Exemple

const tool = weave.startTool({name: 'get_weather', args: {city: 'Tokyo'}});
try {
  const result = await getWeather('Tokyo');
  tool.end({result});
} catch (error) {
  tool.end({error: error as Error, errorType: 'weather_error'});
  throw error;
}

Hérite de

SpanBase

Propriétés

args

readonly args : string

nom

readonly nom: string

result

Obsolète. Passez plutôt result à end().

facultatif result: string

Sortie de l’outil sous forme de chaîne. Préférez passer result à end().

toolCallId

readonly toolCallId: string

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.

Paramètres

string

requis

Attributes

TimeInput

Renvoie

this

Exemple

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

Hérité de

SpanBase.addEvent

end()

end(opts?) : void

Enregistrez un résultat et un type d’erreur facultatifs, puis fermez le span. Idempotent. Transmettez error pour marquer le span comme ayant échoué et endTime pour antidater la fermeture.

Paramètres

ToolEndOptions

Voir ToolEndOptions.

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).

Paramètres

Attributes

requis

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

Renvoie

Exemple

Hérité de

end()

Paramètres

Renvoie

setAttributes()

Paramètres

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

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