> ## 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

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

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/fr-ca/api/management/v2.md) au moyen des opérations CRUD standards.

## Créer et enregistrer un nouvel agent

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

**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**.

**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 :

**Auth0 CLI**

Vous utilisez l'Auth0 CLI? Si ce n'est pas déjà fait, [configurez et authentifiez votre session CLI](https://auth0.com/docs/fr-ca/deploy-monitor/auth0-cli.md) avant d'exécuter cette commande.

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

**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"
    }
  }'
```

| Champ | Obligatoire | Description |
| - | - | - |
| `name` | Oui | 1 à 255 caractères. |
| `client_id` | Non | [Associer un client existant](https://auth0.com/docs/fr-ca/ai-agents-mcp/agent-as-principal/associate-agent-client.md) 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. |

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.

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"
}
```

## Objet agent

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`.

## `external_agent_id`

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.

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.

## Prochaines étapes

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