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

# L'agent comme mandant

> Enregistrez les agents d'IA à titre d'identités à part entière dans Auth0, avec leur propre cycle de vie, leurs informations d'identification et leur piste de vérification.

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="Agent as Principal" stage="ea" contact="Auth0 Support" terms="true" />

L’agent comme mandant fait des agents d'IA des identités de première classe dans Auth0, distinctes des utilisateurs humains et des clients traditionnels de communication entre machines (M2M). Un agent est une entité enregistrée dotée d'un identifiant stable, de sa propre gestion du cycle de vie, de ses propres informations d'identification et de sa propre piste d'audit.

Une fois enregistré comme principal Auth0, un agent peut :

* agir au nom de l'utilisateur;
* s'exécuter de façon autonome, sans session utilisateur;
* participer à une délégation à sauts multiples par échange de jetons.

<h2 id="use-cases">
  Cas d'utilisation
</h2>

* Agents autonomes : un agent d'IA utilise des informations d'identification de client pour appeler directement des API en son propre nom, son identité étant consignée dans les journaux et les jetons.
* Accès délégué : un utilisateur autorise un agent d'IA à agir en son nom. L'agent échange le jeton d'accès de l'utilisateur contre un jeton délégué qui conserve l'utilisateur comme sujet et désigne l'agent comme acteur.
* Chaînes à sauts multiples : un agent orchestrateur délègue à un sous-agent. La chaîne de délégation est préservée dans des demandes `act` imbriquées, ce qui permet une traçabilité complète à n'importe quel serveur de ressources.

<h2 id="how-it-works">
  Fonctionnement
</h2>

L'agent comme mandant fonctionne en trois étapes : l'enregistrement, l'association du client et l'émission du jeton.

```mermaid theme={null}
flowchart LR
    A([Vous]) -->|"POST /api/v2/agents"| B[("Auth0\n(agent_id attribué)")]
    B -->|"PATCH /api/v2/clients/{id}"| C["Client M2M\n(lié à un agent)"]
    C --> D{"S’authentifier"}
    D -->|"Information d’identification du client"| E["Jeton\nsub = agent_id\nsub_profile = ai_agent"]
    D -->|"Échange OBO"| F["Jeton\nsub = user\nact.sub = agent_id"]
    D -->|"Connexion standard"| G["Jeton\nsub = user\nact.sub = agent_id"]
    E --> H[("Journaux du locataire\n+ Actions")]
    F --> H
    G --> H
```

1. [Enregistrer l'agent](/docs/fr-ca/ai-agents-mcp/agent-as-principal/register-an-agent) : vous enregistrez un agent dans Auth0 à l'aide du Dashboard ou de la Management API. Auth0 crée un [objet agent](/docs/fr-ca/ai-agents-mcp/agent-as-principal/register-an-agent#agent-object) doté d'un `agent_id` stable qu'il est possible de suivre dans les jetons, les journaux et la Management API tout au long de son cycle de vie.

2. [Associer l'agent à un client](/docs/fr-ca/ai-agents-mcp/agent-as-principal/associate-agent-client) : un agent ne possède pas d'information d'identification qui lui soit propre; il s'authentifie par l'entremise d'un ou de plusieurs clients associés. Un même agent peut être lié à plusieurs clients, ce qui est utile pour avoir des clients distincts par environnement ou par région tout en conservant une seule identité logique dans les journaux.

3. [Identité de l'agent dans les jetons](/docs/fr-ca/ai-agents-mcp/agent-as-principal/agent-identity-in-tokens) : lorsqu'un client lié à un agent s'authentifie, Auth0 intègre l'identité de l'agent au jeton émis selon le type d'autorisation.

L'`agent_id` (ou l'`external_agent_id`, s'il est défini à la création) est également inscrit dans les [journaux du locataire](/docs/fr-ca/ai-agents-mcp/agent-as-principal/tenant-logs) à chaque émission de jeton, ce qui vous procure une piste de vérification complète pour chaque agent. Vous pouvez aussi accéder à l'identité de l'agent dans les [Actions](/docs/fr-ca/ai-agents-mcp/agent-as-principal/actions-context) au moyen de `event.agent` afin d'appliquer une logique personnalisée au moment de l'émission du jeton.

<h2 id="migration-guidance">
  Conseils de migration
</h2>

Migrez vos clients et serveurs de ressources existants afin d'utiliser l'agent comme mandant.

<h3 id="clients">
  Clients
</h3>

Les clients existants ne sont pas touchés, sauf si vous les associez explicitement à un agent. L'association à un agent est optionnelle et réversible. Pour en savoir plus, consultez [Associer un agent à un client](/docs/fr-ca/ai-agents-mcp/agent-as-principal/associate-agent-client).

<h3 id="resource-servers">
  Serveurs de ressources
</h3>

Pour recevoir les demandes `sub_profile` et `client_profile`, définissez `agent_subject_claims: 'auth0-v1'` dans la configuration du serveur de ressources visé. Cette option s'active individuellement pour chaque serveur de ressources. Pour en savoir plus, consultez [Configurer un serveur de ressources pour recevoir les demandes de sujet d'agent](/docs/fr-ca/ai-agents-mcp/agent-as-principal/agent-identity-in-tokens#configure-resource-server-to-receive-agent-subject-claims).