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

# エージェントの登録

> Auth0 Dashboard または Management API を使用してエージェントを作成・登録します

> [!WARNING]
>
> **Agent as Principal機能は現在、です。**

Auth0 Dashboard または Management API を使用して、エージェントを Auth0 の第一級のアイデンティティとして登録します。登録後は、[Management API](https://auth0.com/docs/ja-jp/api/management/v2.md) の標準的な CRUD 操作でエージェントを管理できます。

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

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

> [tab] Auth0 Dashboard
>
> 1. **Dashboard > Agents**に移動し、**Create New Agent**を選択します。
> 2. エージェントの名前を入力します。
> 3. **Create**を選択します。
>
> 作成に成功すると、エージェントには`agt_`プレフィックスが付いた一意の`agent_id`が付与されます。エージェントの詳細を表示するには、**View Details**を選択します。

> [tab] Management API
>
> まず、Management APIのアクセストークンに`create:agents`権限があることを確認します。
>
> 次に、以下のパラメーターを指定して`/api/v2/agents`に`POST`リクエストを送信します。
>
> > [tab] Auth0 CLI
> >
> > Auth0 CLIをお使いですか？まだの場合は、このコマンドを実行する前に[CLIセッションをセットアップして認証](https://auth0.com/docs/ja-jp/deploy-monitor/auth0-cli.md)してください。
> >
> > ```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] 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"
> >     }
> >   }'
> > ```
>
> | フィールド | 必須 | 説明 |
> | - | - | - |
> | `name` | はい | 1〜255文字。 |
> | `client_id` | いいえ | エージェント作成時に[既存のクライアントを関連付けます](https://auth0.com/docs/ja-jp/ai-agents-mcp/agent-as-principal/associate-agent-client.md)。 |
> | `external_agent_id` | いいえ | 作成時にのみ設定でき、作成後は変更できません。詳細については、[`external_agent_id`](#external_agent_id)をお読みください。 |
> | `metadata` | いいえ | JSON、上限10 KB。 |
>
> `name`や`metadata`フィールドには、個人を特定できる情報 (PII) を含めないでください。これらの値はログに記録され、管理者やログストリーミングの送信先から参照される可能性があります。
>
> 成功すると、Auth0は次のようなエージェントオブジェクトを返します。
>
> ```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"
> }
> ```

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

登録すると、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) を含めないでください。この値はログに記録され、管理者やログストリーミングの送信先から参照される可能性があります。

## 次のステップ

* [エージェントをクライアントに関連付ける](https://auth0.com/docs/ja-jp/ai-agents-mcp/agent-as-principal/associate-agent-client.md)ことで、エージェントのアイデンティティを持つトークンを発行できます