エージェントの登録

Auth0 Dashboard または Management API を使用して、エージェントを Auth0 の第一級の ID として登録します。登録後は、Management API の標準的な CRUD 操作でエージェントを管理できます。

新しいエージェントを作成して登録する

Auth0 DashboardとManagement APIを使って、新しいエージェントを作成して登録します。

Auth0 Dashboard
Management API

Dashboard > Agentsに移動し、Create New Agentを選択します。
エージェントの名前を入力します。
Createを選択します。

作成に成功すると、エージェントにはagt_プレフィックスが付いた一意のagent_idが付与されます。エージェントの詳細を表示するには、View Detailsを選択します。

まず、Management APIのアクセストークンにcreate:agents権限があることを確認します。次に、以下のパラメーターを指定して/api/v2/agentsにPOSTリクエストを送信します。

Auth0 CLI
cURL

Auth0 CLIをお使いですか？まだの場合は、このコマンドを実行する前にCLIセッションをセットアップして認証してください。

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

フィールド	必須	説明
`name`	はい	1〜255文字。
`client_id`	いいえ	エージェント作成時に既存のクライアントを関連付けます。
`external_agent_id`	いいえ	作成時にのみ設定でき、作成後は変更できません。詳細については、`external_agent_id`をお読みください。
`metadata`	いいえ	JSON、上限10 KB。

nameやmetadataフィールドには、個人を特定できる情報 (PII) を含めないでください。これらの値はログに記録され、管理者やログストリーミングの送信先から参照される可能性があります。

成功すると、Auth0は次のようなエージェントオブジェクトを返します。

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

エージェントオブジェクト

登録すると、Auth0は次のオブジェクトスキーマでエージェントを保存します。

フィールド	型	説明
`agent_id`	string	サーバーが生成します。形式は`agt_` + base58文字22文字です。変更できません。`external_agent_id`が設定されている場合でも、Management API経由でエージェントを指定する際には常にこの値を使用します。
`external_agent_id`	string	任意。顧客が指定する識別子です。作成時に設定する必要があり、後から追加や変更はできません。設定した場合、トークンのクレームやテナントログでは`agent_id`の代わりにこの値が使用されます。
`name`	string	1〜255文字。作成時に必須です。
`metadata`	object	JSON、上限10 KB。
`created_at`	string	ISO 8601形式のタイムスタンプ。
`updated_at`	string	ISO 8601形式のタイムスタンプ。

エージェントオブジェクトは、/api/v2/agentsのすべてのエンドポイントから返されます。

`external_agent_id`

external_agent_id を使うと、エージェントに独自の識別子を指定できます。これにより、トークンやログに表示されるエージェントのアイデンティティを、自社システムですでに使用している ID と一致させられます。external_agent_id はエージェントの作成時に指定する必要があり、後から追加したり変更したりすることはできません。設定すると、発行されるトークン (sub、act.sub) やテナントログでエージェントのアイデンティティが表示される箇所では、agent_id に代わって external_agent_id が使用されます。external_agent_id を設定しているかどうかにかかわらず、Management API でエージェントを管理する際に使用する識別子は、引き続き内部の agent_id です。

external_agent_id には個人を特定できる情報 (PII) を含めないでください。この値はログに記録され、管理者やログストリーミングの送信先から参照される可能性があります。

次のステップ

エージェントをクライアントに関連付けることで、エージェントのアイデンティティを持つトークンを発行できます

はじめに

リファレンス

エージェントの登録

新しいエージェントを作成して登録する

エージェントオブジェクト

`external_agent_id`

次のステップ

​新しいエージェントを作成して登録する

​エージェントオブジェクト

​external_agent_id

​次のステップ

新しいエージェントを作成して登録する

エージェントオブジェクト

`external_agent_id`

次のステップ