Passer au contenu principal
weave / SubAgent Une invocation d’agent imbriquée — utilisée lorsque l’agent actuel délègue une tâche à un autre agent identifié par un nom (par ex. un planificateur appelant un chercheur). Émet un span invoke_agent associé au nom du sous-agent et, éventuellement, à son modèle. Créé par weave.startSubagent() (ou turn.startAgent(), ou llm.startAgent()) et terminé avec end(). Exemple
const  = weave.startSubagent({: 'researcher', : 'gpt-4o'});
try {
  // ... orchestrer les appels LLM/Tool du sous-agent ...
} finally {
  .end();
}

Hiérarchie

  • SpanBase SubAgent

Table des matières

Propriétés

Méthodes

Propriétés

model

Readonly model: string

Défini dans

src/genai/subagent.ts:41

nom

Readonly nom: string

Défini dans

src/genai/subagent.ts:40

Méthodes

addEvent

addEvent(name, attributes?, startTime?): this Ajoute un événement nommé au span. Utile pour marquer des moments qui ne correspondent pas à des spans, comme la compaction du contexte, la détection de boucles d’outil ou le déclenchement de guardrails. Émet un avertissement et n’a aucun effet après end(). Reproduit le comportement de OTel Span.addEvent.

Paramètres

NomType
namestring
attributes?Attributes
startTime?TimeInput

Renvoie

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

Hérité de

SpanBase.addEvent

Défini dans

src/genai/spanBase.ts:77

end

end(opts?): void Ferme le span du SubAgent. Cette opération est idempotente. Passez error pour marquer le span comme ayant échoué; passez endTime pour antidater la fermeture.

Paramètres

NomType
opts?SpanEndOptions

Renvoie

void

Défini dans

src/genai/subagent.ts:72

setAttributes

setAttributes(attributes): this Définit plusieurs attributs du span en une seule fois. Affiche un avertissement et n’a aucun effet après end(). Reprend le comportement de OTel Span.setAttributes (et de set_attributes du SDK Python).

Paramètres

NomType
attributesAttributes

Renvoie

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

Hérité de

SpanBase.setAttributes

Défini dans

src/genai/spanBase.ts:63

create

create(opts): SubAgent

Paramètres

NomType
optsSubAgentInit & ChildSpanContext

Renvoie

SubAgent

Défini dans

src/genai/subagent.ts:46