Guide d'action
Enregistre chaque invocation de tool faite par ton agent
POST
/v1/events · agent.tool_calledÉmets un event `agent.tool_called` au moment où ton agent IA décide d'invoquer un tool, avant son exécution. Capture l'identité de l'agent, le nom du tool, les arguments et l'utilisateur qui a déclenché la conversation. À utiliser avec `agent.tool_returned` pour une traçabilité complète.
Quand l'émettre
Juste après que le modèle a retourné un bloc tool_use et que ton wrapper a extrait le nom et les arguments, avant que la fonction du tool ne tourne.
Payload d'exemple
await recalled.events.create({
action: "agent.tool_called",
actor: { id: user.id, email: user.email },
organization: user.organizationId,
metadata: {
triggered_by_user: "value",
conversation_id: "value",
tool_call_id: "value"
},
});Metadata à inclure
Garde les metadata plates et cohérentes dans ton service pour que recherche et exports CSV fonctionnent bien.
| Clé | Rôle |
|---|---|
triggered_by_user | Id interne de l'humain qui a démarré la conversation |
conversation_id | Ton id de conversation ou session, rattache l'event au chat |
tool_call_id | tool_call_id du provider (Anthropic, OpenAI), utile pour les rejeux |
tool_name | Nom du tool que l'agent a décidé d'appeler |
tool_args | Arguments que l'agent a passés au tool |
model | Id du modèle, par exemple claude-sonnet-4.6 |
reasoning | Courte raison optionnelle quand le modèle l'expose |
Rétention recommandée
Garder au moins 6 mois. Utile pour rejouer les décisions d'agent quand un user conteste un tool call.