Guide d'action

Enregistre le changement d'état réel fait par ton agent

POST/v1/events · agent.action_taken

Émets un event de domaine avec `actor.type` à 'agent' pour le changement effectif que ton agent a opéré (file.deleted, invoice.refunded, project.archived). C'est l'enregistrement de niveau audit que les clients et auditeurs regarderont en premier en cas de litige.

Commencer gratuitement Ouvrir le playground

Quand l'émettre

Après que le tool orchestré par l'agent a vraiment muté l'état (write DB committée, API tierce confirmée). Au même endroit qu'une version humaine de l'action loggerait.

Payload d'exemple

await recalled.events.create({
  action: "agent.action_taken",
  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`	User id de l'humain qui a démarré la conversation
`conversation_id`	Id de conversation, pour le rejeu
`tool_call_id`	tool_call_id d'où vient cette action
`model`	Id du modèle de l'agent
`confidence`	Niveau de confiance optionnel, low / medium / high
`reasoning`	Raison courte pour laquelle l'agent a pris cette action
`result`	success ou failure

Rétention recommandée

Garder au moins 12 mois. C'est l'enregistrement de niveau audit de ce que ton agent a vraiment fait sur les données.

Actions liées

Logger quand un agent IA appelle un tool

agent.tool_called

Logger quand un tool renvoie à l'agent

agent.tool_returned

Logger les suspensions admin

admin.user.suspended