Enregistrer un agent

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 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
Management API

Accédez à Dashboard > Agents et sélectionnez Créer un nouvel agent.
Saisissez un nom pour l’agent.
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.

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
cURL

Vous utilisez l’Auth0 CLI? Si ce n’est pas déjà fait, configurez et authentifiez votre session CLI avant d’exécuter cette commande.

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

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

{
    "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 pour émettre des jetons portant l’identité de l’agent

Premiers pas

Référence

Enregistrer un agent

Créer et enregistrer un nouvel agent

Objet agent

`external_agent_id`

Prochaines étapes

​Créer et enregistrer un nouvel agent

​Objet agent

​external_agent_id

​Prochaines étapes

Créer et enregistrer un nouvel agent

Objet agent

`external_agent_id`

Prochaines étapes