> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/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 les Actions Auth0 à l’aide de l’objet `event.agent`.

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "bêta",
    "ea": "Accès anticipé"
  };
  const stageText = stageTextMap[stage] || "une phase de lancement du produit";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>Cette fonctionnalité est offerte avec les forfaits {linkify(`${plans}`, "https://auth0.com/pricing")}. </>}
            {contact && "Pour y participer, communiquez avec " + contact + ". "}
            {terms && <>En utilisant cette fonctionnalité, vous acceptez les conditions applicables de l’essai gratuit énoncées dans le {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} d’Okta.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>La fonctionnalité {feature} est en {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Agents as Principal" stage="ea" contact="Auth0 Support" terms="true" />

Lorsqu'une requête implique un client lié à un agent, l'environnement d'exécution des Actions expose un objet `event.agent`. Cet objet est absent lorsqu'aucun agent n'est impliqué; le code Actions existant n'est donc pas affecté.

<div id="triggers">
  ## Déclencheurs
</div>

`event.agent` est présent dans les déclencheurs suivants :

| Déclencheur            | Lorsque `event.agent` est présent                                                                       |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| `credentials-exchange` | Octroi de type Client Credentials lorsque `agent_id` est défini pour le client.                         |
| `post-login`           | Code d’autorisation, échange de jetons ou flux d’appareil lorsque `agent_id` est défini pour le client. |

<div id="eventagent-object">
  ## Objet `event.agent`
</div>

L’objet `event.agent` a le schéma suivant :

```json theme={null}
{
  "agent_id": "agt_72jbvv7LfRKYp59gtRLtkn",
  "agent_metadata": {
    "env": "prod"
  }
}
```

`event.client` reste inchangé ; il continue de refléter le client OAuth lié qui a authentifié la requête.

<div id="example-custom-claims-on-agent-tokens">
  ## Exemple : revendications personnalisées dans les jetons d’agent
</div>

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 la création d’Actions, consultez [Write Your First Action](/docs/fr-ca/customize/actions/write-your-first-action).