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 session.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
Table des matières
Propriétés
Méthodes
Propriétés
agentName
Readonly agentName: string
Défini dans
model
Readonly model: string
Défini dans
Méthodes
addEvent
name, attributes?, startTime?): this
Ajoutez un événement nommé au span tour de conversation. 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.
Sans effet après end(). Reproduit le comportement de Span.addEvent d’OTel.
Paramètres
| Nom | Type |
|---|---|
name | string |
attributes? | Attributes |
startTime? | TimeInput |
Renvoie
this
Exemple
Défini dans
end
opts?): void
Ferme le span tour de conversation. Cette opération est idempotente. Passez error pour le marquer comme ayant échoué.
Paramètres
| Nom | Type |
|---|---|
opts? | Object |
opts.error? | Error |
Renvoie
void
Défini dans
setAttribute
key, value): this
Définit un seul attribut sur le span du tour de conversation. Utile pour consigner des
totaux cumulés en cours d’exécution (par exemple, le coût cumulé ou l’utilisation de jetons) ou d’autres métadonnées qui ne deviennent
connues qu’en cours de tour de conversation. N’a aucun effet après end(). Équivaut à Span.setAttribute d’OTel.
Paramètres
| Nom | Type |
|---|---|
key | string |
value | AttributeValue |
Renvoie
this
Exemple
Défini dans
startLLM
opts): LLM
Démarre un span LLM enfant dans ce tour de conversation.
Paramètres
| Nom | Type |
|---|---|
opts | LLMInit |
Renvoie
LLM
Défini dans
startSubagent
opts): SubAgent
Démarre un span SubAgent enfant au sein de ce tour de conversation.
Paramètres
| Nom | Type |
|---|---|
opts | SubAgentInit |
Renvoie
SubAgent
Défini dans
startTool
opts): Tool
Démarre un span enfant de Tool dans ce tour de conversation.
Paramètres
| Nom | Type |
|---|---|
opts | ToolInit |
Renvoie
Tool
Défini dans
create
opts?): tour de conversation
Paramètres
| Nom | Type |
|---|---|
opts | TurnInit & { conversationId?: string } |
Renvoie
tour de conversation