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

# Enregistrer un agent

> Créez et enregistrez des agents à l'aide du Auth0 Dashboard ou de la Management API

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" />

Enregistrez un agent comme identité de premier ordre dans Auth0 à l'aide du Auth0 Dashboard ou de la Management API. Une fois l'agent enregistré, vous pouvez le gérer avec la [Management API](https://auth0.com/docs/api/management/v2) au moyen des opérations CRUD standards.

<h2 id="create-and-register-a-new-agent">
  Créer et enregistrer un nouvel agent
</h2>

Créez et enregistrez un nouvel agent avec le Auth0 Dashboard et la Management API.

<Tabs>
  <Tab title="Auth0 Dashboard">
    1. Accédez à **Dashboard > Agents** et sélectionnez **Créer un nouvel agent**.
    2. Saisissez un nom pour l'agent.
    3. Sélectionnez **Créer**.

    Une fois l'agent créé, il devrait avoir un `agent_id` unique portant le préfixe `agt_`. Pour afficher les détails de l'agent, sélectionnez **Afficher les détails**.
  </Tab>

  <Tab title="Management API">
    D'abord, assurez-vous que votre jeton d'accès de la Management API possède l'autorisation `create:agents`.

    Ensuite, effectuez une requête `POST` à `/api/v2/agents` avec les paramètres suivants :

    <Tabs>
      <Tab title="Auth0 CLI">
        <Callout icon="file-lines" color="#0EA5E9" iconType="regular">Vous utilisez l'Auth0 CLI? Si ce n'est pas déjà fait, [configurez et authentifiez votre session CLI](/docs/fr-ca/deploy-monitor/auth0-cli) avant d'exécuter cette commande.</Callout>

        ```bash theme={null}
        auth0 api post "agents" \
          --data '{
            "name": "recommendation-agent-prod",
            "external_agent_id": "my-org-agent-042",
            "metadata": {
              "env": "prod",
              "team": "personalization"
            }
          }'
        ```
      </Tab>

      <Tab title="cURL">
        ```bash theme={null}
        curl --request POST \
          --url 'https://YOUR_AUTH0_DOMAIN/api/v2/agents' \
          --header 'Content-Type: application/json' \
          --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
          --data '{
            "name": "recommendation-agent-prod",
            "external_agent_id": "my-org-agent-042",
            "metadata": {
              "env": "prod",
              "team": "personalization"
            }
          }'
        ```
      </Tab>
    </Tabs>

    | Champ | Obligatoire | Description |
    | - | - | - |
    | `name` | Oui | 1 à 255 caractères. |
    | `client_id` | Non | [Associer un client existant](/docs/fr-ca/ai-agents-mcp/agent-as-principal/associate-agent-client) lors de la création de l'agent. |
    | `external_agent_id` | Non | Ne peut être défini qu'au moment de la création. Il est impossible de le modifier par la suite. Pour en savoir plus, consultez [`external_agent_id`](#external_agent_id). |
    | `metadata` | Non | JSON, limite de 10 Ko. |

    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      N'incluez pas de renseignements personnels identifiables (RPI) dans les champs `name` ou `metadata`. Ces valeurs sont consignées dans les journaux et peuvent être visibles par les administrateurs et les destinations d'exportation des journaux.
    </Callout>

    Si l'opération réussit, Auth0 renvoie un objet agent semblable à celui-ci :

    ```json theme={null}
    {
        "agent_id": "agt_sJsP2T4rLopMQMWz2eEGmW",
        "name": "recommendation-agent-prod",
        "metadata": {
            "env": "prod",
            "team": "personalization"
        },
        "created_at": "2026-07-28T21:40:01.395Z",
        "updated_at": "2026-07-28T21:40:01.395Z",
        "external_agent_id": "my-org-agent-042"
    }
    ```
  </Tab>
</Tabs>

<h2 id="agent-object">
  Objet agent
</h2>

Une fois l'enregistrement effectué, Auth0 stocke l'agent selon le schéma d'objet suivant :

| Champ | Type | Description |
| - | - | - |
| `agent_id` | chaîne | Généré par le serveur. Format : `agt_` + 22 caractères base58. Non modifiable. Toujours utilisé pour désigner l'agent dans la Management API, même lorsque `external_agent_id` est défini. |
| `external_agent_id` | chaîne | Facultatif. Identifiant fourni par le client. Doit être défini à la création; il ne peut être ajouté ni modifié par la suite. Lorsqu'il est défini, il remplace `agent_id` dans les demandes du jeton et les journaux du locataire. |
| `name` | chaîne | De 1 à 255 caractères. Obligatoire à la création. |
| `metadata` | objet | JSON, limite de 10 Ko. |
| `created_at` | chaîne | Horodatage ISO 8601. |
| `updated_at` | chaîne | Horodatage ISO 8601. |

L'objet agent est retourné par tous les terminaux `/api/v2/agents`.

<h2 id="external_agent_id">
  `external_agent_id`
</h2>

Vous pouvez fournir votre propre identifiant pour un agent au moyen de `external_agent_id`, afin que l'identité de l'agent affichée dans les jetons et les journaux corresponde à un ID déjà utilisé dans vos propres systèmes. Vous devez préciser le `external_agent_id` au moment de la création de l'agent; il est impossible de l'ajouter ou de le modifier par la suite.

Lorsqu'il est défini, le `external_agent_id` remplace `agent_id` partout où l'identité de l'agent apparaît dans les jetons émis (`sub`, `act.sub`) ainsi que dans les journaux du locataire. Le `agent_id` interne demeure l'identifiant servant à gérer l'agent au moyen de la Management API, que vous ayez défini un `external_agent_id` ou non.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  N'incluez aucun renseignement personnel identifiable (RPI) dans `external_agent_id`. Cette valeur est consignée dans les journaux et peut être visible par les administrateurs et les destinations d'exportation des journaux.
</Callout>

<h2 id="next-steps">
  Prochaines étapes
</h2>

* [Associer un agent à un client](/docs/fr-ca/ai-agents-mcp/agent-as-principal/associate-agent-client) pour émettre des jetons portant l'identité de l'agent