> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contexte de l'agent dans les Actions

> Accédez à l'identité et aux métadonnées de l'agent dans Auth0 Actions grâce à l'objet `event.agent`.

> [!WARNING]
>
> **La fonctionnalité Agent as Principal est en .**

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 :

```json theme={null}
{
  "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 :

```javascript theme={null}
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](https://auth0.com/docs/fr-ca/customize/actions/write-your-first-action.md).