Outil

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 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 ainsi que 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;
}

Étend

SpanBase

Propriétés

args

readonly args: string

name

readonly name: string

result

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

optional result: string

Sortie de l’outil, sous forme de chaîne. Passez de préférence result à end().

toolCallId

readonly toolCallId: string

Méthodes

addEvent()

Obsolète. Enregistrez plutôt ces données avec setAttributes. OpenTelemetry abandonne progressivement l’API Span Event (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 signaler des moments qui ne correspondent pas à un span, comme le compactage du contexte, la détection de boucles d’outils ou le déclenchement de garde-fous. Après end(), émet un avertissement et ne fait rien. Équivalent de 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

Enregistre un résultat et un type d’erreur facultatifs, puis ferme le span. Méthode idempotente. Passez error pour marquer le span comme ayant échoué et endTime pour antidater sa fermeture.

Paramètres

ToolEndOptions

Voir ToolEndOptions.

Renvoie

void

setAttributes()

setAttributes(attributes): this

Définit plusieurs attributs sur le span en une seule fois. Après end(), émet un avertissement et ne fait rien. Équivalent de Span.setAttributes d’OTel (et de set_attributes dans le SDK Python).

Paramètres

Attributes

requis

Renvoie

this

Exemple

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

Hérité de

SpanBase.setAttributes

Weights & Biases

Guides

Intégrations

Référence

Assistance

Exemple

Étend

Propriétés

args

name

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

​Étend

​Propriétés

​args

​name

​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

Étend

Propriétés

args

name

result

toolCallId

Méthodes

addEvent()

Paramètres

Renvoie

Exemple

Hérité de

end()

Paramètres

Renvoie

setAttributes()

Paramètres

Renvoie

Exemple

Hérité de