Passer au contenu principal
weave / tour de conversation Une invocation d’agent. Elle encapsule généralement le travail nécessaire pour répondre à un seul message d’un utilisateur. Elle émet un span invoke_agent et sert de racine à la trace de ce tour de conversation : elle est toujours démarrée sous ROOT_CONTEXT afin de ne jamais hériter 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, startSubagent. Exemple 
const  = weave.startTurn({: 'research-bot', : MODEL});
try {
  const  = .startLLM({: MODEL, : 'openai'});
  // ...
  .end();
} finally {
  .end();
}

​
Hiérarchie

  • SpanBase ↳ tour de conversation

​
Table des matières

​
Propriétés

​
Méthodes

​
Propriétés

​
agentName

• Readonly agentName: string

​
Défini dans

src/genai/turn.ts:57

​
model

• Readonly model: string

​
Défini dans

src/genai/turn.ts:58

​
Méthodes

​
addEvent

▸ addEvent(name, attributes?, startTime?): this Ajoutez un événement nommé au span. Utile pour marquer des moments qui ne correspondent pas à des spans, comme le compactage du contexte, la détection de boucles d’outil ou le déclenchement de garde-fous. Émet un avertissement et est sans effet après end(). Reproduit le comportement de Span.addEvent d’OTel.

​
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 tour de conversation. Cette opération est idempotente. Passez error pour le marquer comme ayant échoué ; passez endTime pour antidater la fermeture.

​
Paramètres

NomType
opts?SpanEndOptions

​
Renvoie

void

​
Défini dans

src/genai/turn.ts:144

​
setAttribute

Obsolète. Utilisez plutôt setAttributes, qui reflète le SDK Python set_attributes et Span.setAttributes d’OTel. Cette méthode est conservée comme un simple alias afin que les appels existants avec un seul attribut continuent de fonctionner. Seul tour de conversation la prend en charge — les autres émetteurs n’ont jamais proposé de forme au singulier.
▸ setAttribute(key, value): this

​
Paramètres

NomType
keystring
valueAttributeValue

​
Renvoie

this

​
Défini dans

src/genai/turn.ts:136

​
setAttributes

▸ setAttributes(attributes): this Définit plusieurs attributs sur le span en une seule fois. Émet un avertissement puis n’a aucun effet après end(). Équivaut à Span.setAttributes d’OTel (et à 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

​
startLLM

▸ startLLM(opts): LLM Démarre un span LLM enfant dans ce tour de conversation.

​
Paramètres

NomType
optsLLMInit

​
Renvoie

LLM

​
Défini dans

src/genai/turn.ts:104

​
startSubagent

▸ startSubagent(opts): SubAgent Démarre un span SubAgent enfant au sein de ce tour de conversation.

​
Paramètres

NomType
optsSubAgentInit

​
Renvoie

SubAgent

​
Défini dans

src/genai/turn.ts:122

​
startTool

▸ startTool(opts): Tool Démarre un span enfant de Tool dans ce tour de conversation.

​
Paramètres

NomType
optsToolInit

​
Renvoie

Tool

​
Défini dans

src/genai/turn.ts:113

​
create

▸ create(opts?): tour de conversation

​
Paramètres

NomType
optsTurnInit & { conversationId?: string }

​
Renvoie

tour de conversation

​
Défini dans

src/genai/turn.ts:63