Contexte de l'agent dans les Actions

Lorsqu’une requête met en jeu un client lié à un agent, le moteur d’exécution des Actions expose un objet event.agent. Cet objet est absent lorsqu’aucun agent n’intervient, ce qui n’a donc aucune incidence sur le code des Actions existant.

Triggers

event.agent est présent dans les triggers suivants :

Trigger	Cas où `event.agent` est présent
`credentials-exchange`	Octroi par informations d’identification client lorsque le client a un `agent_id` défini.
`post-login`	Code d’autorisation, échange de jetons ou flux d’appareil lorsque le client a un `agent_id` défini.

Objet `event.agent`

L’objet event.agent possède le schéma suivant :

{
  "agent_id": "agt_72jbvv7LfRKYp59gtRLtkn",
  "agent_metadata": {
    "env": "prod"
  }
}

event.client demeure inchangé : il continue de représenter le client OAuth lié qui a authentifié la requête.

Exemple : demandes personnalisées dans les jetons d’agent

Utilisez event.agent dans une Action credentials-exchange pour ajouter le contexte de l’agent aux jetons d’accès :

exports.onExecuteCredentialsExchange = async (event, api) => {
  if (event.agent) {
    api.accessToken.setCustomClaim('agent_env', event.agent.agent_metadata?.env);
    api.accessToken.setCustomClaim('agent_id', event.agent.agent_id);
  }
};

Pour en savoir plus sur l’écriture d’Actions, consultez Écrire votre première Action.

Premiers pas

Référence

Contexte de l'agent dans les Actions

Triggers

Objet `event.agent`

Exemple : demandes personnalisées dans les jetons d’agent

​Triggers

​Objet event.agent

​Exemple : demandes personnalisées dans les jetons d’agent

Triggers

Objet `event.agent`

Exemple : demandes personnalisées dans les jetons d’agent