27 AIレジストリ

AIレジストリは、Oracle AI Data PlatformのエージェントおよびMCPサーバーの中心的なカタログです。MCPやA2Aなどのオープン標準をサポートしています。

AIデータ・プラットフォームは、エージェントが構築およびデプロイされる場所です。Oracle Agent Hubは、ビジネス・ユーザーが対話する場所です。AIレジストリはそれらの間のレイヤーです。AIレジストリは、エージェントまたはツールを検出可能にし、それが構築された環境外で使用できるようにします。エージェントおよびツールは、エージェント・ハブで共有する前にAIレジストリに登録する必要があります。Oracle Agent Hubの使用のエージェント・ハブでのエンタープライズAIの仕組みを参照してください。

AIデータ・プラットフォームAIレジストリに次のエージェントおよびツールを登録できます:

入力してください 説明
AI Data Platformエージェント AIデータ・プラットフォームで構築およびデプロイされた、アクセス権のあるワークスペース内のエージェント。AIデータ・プラットフォームAIレジストリのローカル・エージェントとも呼ばれます。
外部代理店 AI Data Platformの外部でホストされるエージェントで、A2Aエージェント・カードURLによって追加されます。
MCPサーバー エージェントがコールできる一連のツールを公開するModel Context Protocol (MCP)サーバー。

AIレジストリでは、AIエージェント、MCPサーバー、および両方を使用するために必要な資格証明を管理できます。「AIレジストリ」ページでは、「エージェント」、「MCPサーバー」および「資格証明」タブを使用して、それぞれのリストを表示できます。検索バーを使用して、表示可能なオプションを名前または説明でフィルタできます。「エージェント」タブで、「ソート基準」ドロップダウン・メニューを使用して、レジストリにエージェントが追加された時期でソートできます。

エージェント・カードをクリックすると、そのエージェントの詳細が表示され、作成者、ソース、バージョン、エージェント・カードのURLおよびプロトコル・バージョンが示されます。カードの右上隅にあるオプションを使用して、詳細ビューとカードのJSONビューを切り替えることができます。

新しい外部エージェントまたはMCPサーバーを登録する前に、まず認証資格証明を「資格証明」タブに登録する必要があります。次に、右上の「登録」をクリックして適切なオプションを選択すると、新しいエージェントおよびMCPサーバーを登録できます。AIレジストリの権限は、「権限」タブから管理されます。

エージェント・カードについて

エージェント・カードは、エージェントを記述するメタデータ構造です。AIレジストリは、登録時にそれらを読み取り、コミットする前にレビューのために表示します。

詳細は、A2A Protocol Specificationを参照してください。

エージェントカードには次の情報が含まれます。
  • 名前、バージョンおよび説明。
  • エージェント・カードURL。カード自体が公開される場所です。
  • プロトコルのバージョン
  • 入力モードと出力モード。たとえば、text、text/plain、text/htmlなどです。
  • ストリーミングなどの機能。
  • スキル、それぞれに独自の名前と説明があります。
カードはオーケストレーションが照合するものです。エージェントを選択せずにエージェント・ハブで質問すると、このカードの名前、説明、スキルおよび機能によって、エージェントが出現するかどうかが決まります。曖昧な説明は、エージェントが選択されない最も一般的な理由です。

AIレジストリでの資格証明の作成

エージェントやMCPサーバーなどのAIレジストリ・オブジェクトの認証に使用するために必要な資格証明を保存できます。

  1. ホーム・ページで、AIレジストリアイコン「AIレジストリ」をクリックします。
  2. 「資格証明」タブをクリックし、「資格証明の作成」をクリックします。
  3. 資格証明の名前と説明を入力します。
  4. ドロップダウン・メニューから資格証明タイプを選択します。
  5. ドロップダウン・メニューから権限付与タイプを選択します。
  6. 資格証明の「認可URL」、「アクセス・トークンURL」、「クライアントID」、「クライアント・シークレット」および「リフレッシュURL」を入力します。
  7. スコープの名前と値を入力します。少なくとも1つのスコープ名および値が必要です。「スコープの追加」をクリックして、スコープの名前と値を追加します。
  8. リダイレクトURLをコピーします。リダイレクトURLをアイデンティティ・ドメインの機密アプリケーションに貼り付ける必要があります。次の例では、リダイレクトURLをOracle Cloud Infrastructureにコピーする方法を示します:
    1. OCIコンソールにログインします。
    2. 「Identity & Security」、「Domains」、「Integrated applications」の順にクリックします。
    3. リダイレクトURLを更新するアプリケーションを選択します。
    4. OAuth構成タブをクリックし、OAuth構成の編集をクリックします。
    5. 必要なリダイレクトURLを適用し、「送信」をクリックします。
  9. 「作成」をクリックします。

AIレジストリへのローカル・エージェントの登録

アクセス権があるOracle AI Data PlatformワークスペースからローカルAIエージェントを登録できます。

エージェントをAIレジストリに登録するには、AIデータ・プラットフォームにデプロイする必要があります。エージェントのデプロイメントを参照してください。
  1. ホーム・ページで、AIレジストリアイコン「AIレジストリ」をクリックします。
  2. 「登録」をクリックして、「エージェント」をクリックします。
  3. 「ローカル・エージェント」をクリックします。
  4. 「ワークスペース」ドロップダウン・メニューから、ローカル・エージェントが存在するワークスペースを選択します。
  5. 「エージェント」ドロップダウン・メニューから、登録するエージェントを選択します。
  6. オプション: エージェント・カードをプレビューするには、カード・アイコンの上にカーソルを置きます。
  7. 「次へ」をクリックしてください。
  8. エージェントの詳細が正しいことを確認し、「登録」をクリックします。

AIレジストリへの外部エージェントの登録

サポートされているソースからAIレジストリに外部AIエージェントを登録できます。これらのエージェントは、A2Aプロトコルに準拠している必要があります。

外部エージェントが認証を必要とする場合は、まずAIレジストリの「資格証明」タブでそれらの資格証明を作成します。
  1. ホーム・ページで、AIレジストリアイコン「AIレジストリ」をクリックします。
  2. 「登録」をクリックして、「エージェント」をクリックします。
  3. 「外部エージェント」をクリックします。
  4. エージェント・カードのURLを入力します。
  5. オプション: エンドポイントにセキュアな資格証明が必要な場合は、「認証が必要」を選択し、「資格証明」ドロップダウン・メニューから資格証明を選択します。
  6. 「次へ」をクリックしてください。
  7. オプション: 「認証が必要」を選択した場合は、表示されるダイアログでエージェントに資格があるアカウントの資格証明を入力します。
  8. エージェントの詳細を確認して、「登録」をクリックします。

AIレジストリへのMCPサーバーの登録

MCPサーバーは、エージェントが標準インタフェースを検出して呼び出すことができる一連のツールを公開します。AIレジストリに登録すると、これらのツールがプラットフォームで使用できるようになります。

ノート:

MCPサーバーで認証が必要な場合は、まずAIレジストリにOAuth資格証明を作成する必要があります。資格証明は、MCPサーバーの登録の一部として追加できません。
  1. ホーム・ページで、AIレジストリアイコン「AIレジストリ」をクリックします。
  2. 「Register」をクリックし、「MCP Server」をクリックします。
  3. MCPサーバー・エンドポイントのURLを入力します。
  4. 有用な表示名および説明を入力します。ユーザーおよびエージェントは、これらを使用してMCPサーバーの目的を特定します。
  5. ドロップダウン・メニューから、「トランスポート」メソッドを選択します。
  6. オプション: MCPサーバーにセキュアな資格証明が必要な場合は、「認証が必要」を選択します。「資格証明」ドロップダウン・メニューから資格証明を選択します。
  7. 「続行」をクリックします。
  8. 選択したMCPサーバーの付属ツールのリストを確認します。個別に含めるツールを選択するか、「すべて選択」をクリックしてリストされているすべてのツールを含めます。
  9. 「登録」をクリックします。