インポートされたAIエージェントを構成する

AIエージェントをインポートしたら、次に構成を完了してOktaでアクティブ化します。AIエージェントを構成する際には、次の詳細を提供できます。

• オーナー（Owners）（任意）：AIエージェントのガバナンスとライフサイクル管理を担当する管理者。プロバイダーアプリの構成時にデフォルトの所有者を割り当てた場合、それらの所有者はすでにAIエージェントに自動入力されています。この所有権を変更し、所有者を追加できます。AIエージェントに常に所有者がいるように、少なくとも2人の所有者を割り当てることをお勧めします。
• クライアント登録（Client registration）：AIエージェントがOktaに自身のIDを証明するために使用する認証方法。これは、クライアントID、クライアントシークレット、または公開鍵/秘密鍵のいずれかです。
• ユーザーアクセス（User access）：AIエージェントへのユーザーアクセスを管理するアプリ。AIエージェントは、選択したアプリにユーザーがサインインしている場合にのみ、ユーザーに代わって動作できます。AIエージェントがアプリにバインドされている場合、アプリページの上部にリンクされたAIエージェント（Linked AI Agent）と表示され、バインドされているAIエージェントへのリンクも表示されます。1つのAIエージェントにバインドできるアプリは1つだけです。
• マシンアクセス（Machine access）：AIエージェントを呼び出すことができるアプリ、サービス、その他のAIエージェントです。AIエージェントにマシンアクセスを付与すると、マシンはユーザーなしでAIエージェントの代わりに動作できます。「エージェント間接続」を参照してください。
  注: 別のAIエージェントにマシンアクセスを付与すると、Oktaは2つのAIエージェント間にリソース接続を自動的に作成します。その他の呼び出し元については、AIエージェントのリソース接続を別途構成する必要があります。

開始する前の確認事項

• orgのAIエージェントを管理する権限を持っている。
• AIエージェントをOktaにインポート済みである。「アプリからAIエージェントをインポートする」を参照してください。
• AIエージェントをSAMLアプリにバインドする場合、Cross App Access用に構成している。「リソースサーバーコネクターを設定する」を参照してください。
• AIエージェントをカスタムのOIDCアプリにバインドする場合、そのアプリがorgに統合されている。「OpenID Connectアプリ統合を作成する」を参照してください。
• AIエージェントにマシンアクセスを付与する場合、カスタム認可サーバーを作成済みである。「認可サーバーを作成する」を参照してください。これは、他のAIエージェントやサービスが呼び出せるリソースとしてAIエージェントを登録するために必要です。
• 公開鍵/秘密鍵クライアント登録方式を使用する場合、公開JSON Web Key（JWK）がある。公開JWKがまだない場合は、AIエージェントを登録する際に生成できます。

オーナーの割り当て（任意）

1. オーナー（Owners）タブで、編集（Edit）をクリックします。
2. AIエージェントを個人に割り当てるには、個人オーナーを割り当てる（Assign individual owners）を選択してから、最大5人のオーナーを選択します。
3. AIエージェントをグループに割り当てるには、グループオーナーを割り当てる（Assign a group owner）を選択して、2人以上のメンバーがいるグループを選択します。
4. 保存（Save）をクリックします。

クライアント登録の詳細を追加

複数のクライアント登録方法をステージングできますが、一度に有効にできる方法は1つだけです。

1. クライアント登録（Client registration）タブで、使用するクライアント登録方法の横にある構成（Configure）をクリックします。
   • クライアント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）をクリックします。
2. クライアントID（Client ID）フィールドに表示される識別子をコピーし、AIエージェントビルダーまたは開発者に提供します。
3. アクティブ化（Activate）をクリックします。
   注: クライアント登録方法がすでにアクティブな場合は、切り替え（Switch）ボタンが表示されます。別のクライアント登録方法に切り替えると、元の登録詳細は無効になります。詳細はクライアント登録（Client registration）タブに保持されます。
4. 表示されるダイアログで、有効化（Enable）をクリックします。
   注: AIエージェントビルダーまたは開発者がクライアントシークレットを実装するまで、AIエージェントはこのクライアント登録方法を使用できません。
5. クライアントシークレットまたは公開鍵を非アクティブ化するには、縦の三点記号をクリックして非アクティブ化（Deactivate）を選択します。これを削除するには、縦の省略記号を再度クリックし、削除（Delete）を選択します。

ユーザーアクセスの構成

AIエージェントプロファイル作成時にユーザーアクセス（User access）設定を行った場合は、これらの手順をスキップできます。

1. ユーザーアクセス（User access）タブに移動します。
2. ユーザーアクセス設定を選択します。
   • このAIエージェントにリンクされる新しいOIDCアプリを作成する（Create a new OIDC app linked to this AI agent）：OktaはOIDCアプリを作成し、AIエージェントにバインドします。
   • 既存のアプリを選択する（Select an existing app）：ドロップダウンリストから、SAMLアプリを選択します。
   注: この操作により、AIエージェントがアプリに永続的にバインドされます。変更が必要な場合は、AIエージェントを削除して再作成してください。
3. 保存（Save）をクリックします。

マシンアクセスの設定

非人間の呼び出し元が、独自のアクセストークンがあるリソースとしてAIエージェントにアクセスできるようにします。

1. マシンアクセス（Machine access）タブに移動します。
2. 非人間アイデンティティがAIエージェントを呼び出せるようにするには、カスタム認可サーバーを構成する必要があります。これは1回限りのタスクです。すでに完了している場合は、次のステップに進んでください。完了していない場合は、構成（Configure）をクリックします。
   1. ドロップダウンリストから認可サーバー（Authorization server）を選択します。
   2. 認可サーバーに構成されているオーディエンス/リソースURL（Audience/resource URL）を入力します。
      注:

      オーディエンスURLは、呼び出し元がAIエージェントからトークンをリクエストするために使用する識別子です。この値は後で編集できません。

   3. 保存（Save）をクリックします。
3. 呼び出し元を追加（Add caller）をクリックします。
   1. 別のAIエージェントがこのAIエージェントを呼び出せるようにするには、AIエージェント（AI agent）をクリックします。
      1. ドロップダウンリストからAIエージェントを選択します。
      2. 使用可能なすべてのOAuthスコープをAIエージェントに付与するには、すべて許可（Allow all）を選択します。あるいは、一部のみ許可（Only allow）または禁止（Disallow）を選択し、AIエージェントに付与または拒否するスコープを選択します。
      3. 呼び出し元を追加（Add caller）をクリックします。
   2. アプリまたはサービスがAIエージェントを呼び出せるようにするには、アプリケーションまたはサービス（Application or service）をクリックします。
      1. ドロップダウンリストからアプリまたはサービスを選択します。
      2. 呼び出し元を追加（Add caller）をクリックします。
4. 追加する呼び出し元ごとに、前の手順を繰り返します。

AIエージェントをアクティベートする

1. AIエージェントのページで、アクション（Actions） > アクティブ化（Activate）を選択します。
2. 確定（Confirm）をクリックします。
3. エージェントを非アクティブ化するには、アクション（Actions） > 非アクティブ化（Deactivate）を選択します。

カスタムコードを使用して構築された自社開発（完全にカスタム）または自社開発（エージェントビルダープラットフォーム）のAIエージェントを構成してアクティブ化したら、リソース接続を介してリソースに接続します。「AIエージェントをリソースに接続する」を参照してください。

Amazon Bedrock AgentCore AIエージェントの保護の詳細については、「インポートされたAmazon Bedrock AgentCoreエージェントを保護する」を参照してください。