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

# エージェントの登録

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

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "早期アクセス"
  };
  const stageText = stageTextMap[stage] || "製品リリース段階";
  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 && <>この機能は{linkify(`${plans}プラン`, "https://auth0.com/pricing")}でご利用いただけます。 </>}
            {contact && "参加をご希望の場合は、" + contact + "までお問い合わせください。 "}
            {terms && <>この機能を使用することにより、Oktaの該当する無料トライアル規約および{linkify("Master Subscription Agreement", "https://www.okta.com/legal")}に同意したものとみなされます。</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>{feature}機能は現在、{linkify(stageText, prsLink)}です。</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="プリンシパルとしてのAIエージェント" stage="ea" contact="Auth0 Support" terms="true" />

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

<div id="create-and-register-a-new-agent">
  ## 新しいエージェントを作成して登録する
</div>

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

<Tabs>
  <Tab title="Auth0 Dashboard">
    1. **Dashboard > Agents** に移動し、**Create New Agent** を選択します。
    2. エージェントの名前を入力します。
    3. **Create** を選択します。

    正常に作成されると、エージェントには `agt_` プレフィックス付きの一意の `agent_id` が割り当てられます。エージェントの詳細を表示するには、**詳細を表示** を選択します。
  </Tab>

  <Tab title="Management API">
    まず、Management API access トークン に `create:agents` permission があることを確認します。

    次に、以下のパラメータを指定して `/api/v2/agents` に `POST` request を送信します。

    ```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`         | いいえ | エージェントの作成時に[既存のクライアントを関連付け](/docs/ja-jp/ai-agents-mcp/agents-as-principal/associate-agent-client)ます。 |
    | `external_agent_id` | いいえ | 作成時にのみ設定できます。後から変更することはできません。詳細については、[`external_agent_id`](#external_agent_id)を参照してください。             |
    | `metadata`          | いいえ | JSON、上限10 KB。                                                                                        |

    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      `name` または `metadata` フィールドに個人を特定できる情報 (PII) を含めないでください。これらの値はログに記録され、管理者やログストリーミングの宛先から閲覧できる場合があります。
    </Callout>

    成功すると、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"
    }
    ```
  </Tab>
</Tabs>

<div id="agent-object">
  ## Agent オブジェクト
</div>

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

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

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

<div id="external_agent_id">
  ## `external_agent_id`
</div>

`external_agent_id` を使用すると、エージェントに独自の識別子を指定できます。これにより、トークン や ログ に表示されるエージェントのアイデンティティを、自社システムですでに使用している ID と一致させることができます。`external_agent_id` はエージェントの作成時に指定する必要があり、後から追加または変更することはできません。

`external_agent_id` を設定すると、発行される トークン (`sub`、`act.sub`) およびテナントログ内でエージェントのアイデンティティが表示されるすべての箇所で、`agent_id` の代わりに `external_agent_id` が使用されます。`external_agent_id` の設定有無にかかわらず、内部の `agent_id` は Management API を通じてエージェントを管理する際の識別子として使用されます。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  `external_agent_id` には個人を特定できる情報 (PII) を含めないでください。この値は ログ に記録され、管理者やログストリーミングの宛先から閲覧できる場合があります。
</Callout>

<div id="next-steps">
  ## 次のステップ
</div>

* [エージェント をクライアントに関連付け](/docs/ja-jp/ai-agents-mcp/agents-as-principal/associate-agent-client)、エージェント アイデンティティを持つトークンを発行する