Procedure

1. 次のいずれかのエントリポイントからAIエージェントを登録します。
   • Admin Consoleで、ディレクトリ（Directory） > AIエージェント（AI Agents）に移動し、 AIエージェントを登録（Register AI Agent）をクリックします。
   • あるいは、アプリケーションとリソース（Applications and Resources） > アプリケーション（Application）に移動し、Cross App Access向けに構成されたアプリの統合を選択します。マシン割り当て（Machine Assignments） > リソース（Resources）を選択し、AIエージェントを登録（Register AI Agent）をクリックします。
2. プロファイル（Profile）で、AIエージェントの名前と説明を追加します。
3. 次へ（Next）をクリックします。
4. ユーザーアクセスと認証（User access and authentication） > ユーザーがこのエージェントにアクセスできるようにする（Allow users to access this agent）で、以下のいずれかのオプションを選択します。
   • このAIエージェントにリンクされる新しいOIDCアプリを作成する（Create a new OIDC app linked to this AI agent）：ユーザーがサインインしてAIエージェントにアクセスするためのカスタムOIDCアプリ統合インスタンスを作成します。
   • 既存アプリを選択する（Select an existing app）：ユーザーがサインインしてAIエージェントにアクセスするためにorg内の既存アプリ統合インスタンスを選択します。既存のアプリからAIエージェントを登録すると、このセクションには既存のアプリの情報があらかじめ入力されます。

   詳細については、「AIエージェントの構成設定 - サポートされる要求アプリ」を参照してください。

   Note: OIDCアプリの場合、この操作により、AIエージェントがアプリに永続的にリンクされます。リンクされたOIDCアプリの変更が必要な場合は、AIエージェントを削除して再作成してください。

   ユーザーアクセス（User access）タブで選択したアプリは、XAAフローの要求アプリロールとして機能します。これにより、ユーザーはOktaからエージェントアプリにサインインできるようになります。ユーザーがサインインしていると、エージェントアプリはサインイン済みのユーザーに代わってリソースアプリにアクセスできます。

5. 次へ（Next）をクリックします。AIエージェントは、ステータスが「ステージング済み（STAGED）」の状態でAIエージェント（AI agents）リストに表示されます。

6. クライアント登録（Client registration）タブで、使用するクライアント登録方法の横にある構成（Configure）をクリックします。複数のクライアント登録方法をステージングできますが、一度に有効にできる方法は1つだけです。
   • クライアントIDメタデータドキュメント（CIMD）（Client ID Metadata Document (CIMD)）：開発者がホストするURLによって識別されるAIエージェントに推奨。
     Note: クライアント登録方式としてCIMDを構成する場合、これを後で変更することはできません。
     1. CIMD URLを入力します。
     2. CIMDクライアント登録のアクティブ化（Activate CIMD client registration）をクリックします。
     3. アクティブ化（Activate）をクリックします。CIMD URLがアクティブ化され、 AIエージェントの クライアント登録（Client registration） タブと、 AIエージェントにリンクされるアプリの一般（General） タブに表示されます。
        Note: または、 AIエージェントにリンクされるアプリにCIMD URLを直接追加することもできます。URLは、 AIエージェントのクライアント登録方法として自動的に構成されます。
   • クライアントIDのみ（Client ID only）：ローカルコーディングエージェントなど、シークレットを保存できないパブリッククライアント向けに推奨。
   • クライアントシークレット（Client secret）：サーバー側のAIエージェントに推奨。シークレットを生成（Generate secret）をクリックし、AIエージェントのビルダーまたは開発者に提供します。
   • 公開鍵/秘密鍵（Public/private key）： ビルダー管理のキーペアを持つAIエージェントに推奨。
     1. 公開鍵を追加（Add public key）をクリックします。
     2. 公開鍵を入力するか、新しいキーを生成（Generate new key）をクリックします。Oktaは、JSONまたはPEMで表示できる秘密鍵に関連付けられる公開鍵を作成します。
     3. クリップボードにコピー（Copy to clipboard）をクリックして、秘密鍵を安全な場所に保管します。
     4. 完了（Done）をクリックします。
7. クライアントID（Client ID）フィールドに表示される識別子をコピーし、AIエージェントビルダーまたは開発者に提供します。
8. アクティブ化（Activate）をクリックします。
   Note: クライアント登録方法がすでにアクティブな場合は、切り替え（Switch）ボタンが表示されます。別のクライアント登録方法に切り替えると、元の登録詳細は無効になります。詳細はクライアント登録（Client registration）タブに保持されます。
9. 表示されるダイアログで、有効化（Enable）をクリックします。
   Note: AIエージェントビルダーまたは開発者がクライアントシークレットを実装するまで、AIエージェントはこのクライアント登録方法を使用できません。
10. クライアントシークレットまたは公開鍵を非アクティブ化するには、縦の三点記号をクリックして非アクティブ化（Deactivate）を選択します。これを削除するには、縦の省略記号を再度クリックし、削除（Delete）を選択します。

11. ディレクトリ（Directory） > AIエージェント（AI Agents）のリストから、AIエージェントを選択します。
12. ユーザーアクセス（User access）タブをクリックします。
13. ユーザーアクセス（User access） > このエージェントに割り当てられているユーザーとグループ（Users and groups assigned to this agent）で、アプリケーション（Application） > 割り当て（Assignments）をクリックします。リンクされたSSOアプリの割り当て（Assignments）タブが表示されます。
14. 割り当て（Assignments）タブで、AIエージェントにアクセスできるユーザーまたはグループを選択します。「ユーザーにアプリの統合を割り当てる」と「グループにアプリの統合を割り当てる」を参照してください。
    Note: リンクされたSSOアプリは最初は非アクティブであるため、アプリケーション（Applications）ページから移動した場合、非アクティブ（Inactive）タブに表示される場合があります。

15. AIエージェントページで、アクション（Actions） > アクティブ化（Activate）を選択します。
    Note: AIエージェントのアクティブ化には数秒かかる場合があります。AIエージェントの構成または使用を続行するには、AIエージェントは正常にアクティブ化されました（AI agent activated successfully）というメッセージが表示されるまでお待ちください。

    リンクされた要求アプリをアクティブ化することで、間接的にAIエージェントのアクティブ化もできます。

    1. アプリケーションとリソース（Applications and Resources） > アプリケーション（Applications）に移動します。
    2. ステータス（STATUS）列の非アクティブ（Inactive）タブを選択し、アクティブ化するリンクされた要求アプリを見つけます。
    3. アプリ統合の横にあるドロップダウンメニューからアクティブ化（Activate）を選択します。リンクされたアプリをアクティブ化すると、AIエージェントが自動的にアクティブ化されます。

    AIエージェントを非アクティブ化するには、AIエージェント（AI agent）ページに移動し、アクション（Actions） > 非アクティブ化（Deactivate）を選択します。

    Note:

    • • AIエージェントの非アクティブ化には数秒かかる場合があります。その他の構成を続行するには、AIエージェントは正常に非アクティブ化されました（AI agent deactivated successfully）というメッセージが表示されるまでお待ちください。
      • AIエージェントにリンクされた要求アプリも非アクティブ化されます。