ガバメント・エージェント・カタログにおけるエージェントとツールの管理

作成したエージェントやツール、またはエンドポイントを持っているエージェントは、ガバメント・エージェント・カタログに追加することで共有できます。 エージェントやツールを更新したり、カタログから削除したりして管理することができます。

要件

前提条件
デフォルトのインベントリは、 IBM Cloud の管理者によって作成する必要があります。
必要な許可
カタログ内のエージェントとツールを管理するには、デフォルトインベントリを含むすべてのインベントリで Admin または Editor ロールを持っている必要があります。

カタログへのエージェントまたはツールの追加

エージェントやツールをカタログに追加するには、以下のいずれかの方法があります:

  • エージェントまたはツールのコードを追加する
  • 別のシステムに配置されているエージェントまたはツールのエンドポイントを追加する

エージェントまたはツールのコードを追加する

エージェントやツールのコードを追加して、他の人がAIサービス資産組み込んで、 watsonx.ai でデプロイすることができます。

代理店またはツールの以下の情報を含める必要があります:

ソース・コード
Python。
ランタイムエンジン名
Python。
フレームワーク
LangGraph。
スキーマ
スキーマのフォーマットはJSONでなければならない。

UI からエージェントやツールのコードを追加する:

  1. ナビゲーション・メニューから AI Governance > Governed Agentic Catalogの順にクリックし、 New Tool/Agentをクリックする。
  2. フィールドに必要事項を入力し、「 作成 」をクリックします。

watsonx.governance API を使用してエージェントまたはツールのコードを追加するには、 register_agent() または register_tool() API を呼び出します。 register_agent() または register_tool() を参照。

エントリーを編集して、 メトリック情報を追加することができます。

エージェントまたはツールのエンドポイントの追加

エージェントやツールのエンドポイントを追加することで、他の人がAIサービス資産含めることができ、 watsonx.ai。

代理店またはツールの以下の情報を含める必要があります:

エンドポイント
エンドポイントに使用する URL を入力します。
フレームワーク
LangGraph。
HTTPメソッド
エンドポイントに使用する通話タイプを選択します。
ヘッダー
エンドポイントに必要なキー・ペアの値を定義する。
スキーマ
スキーマのフォーマットはJSONでなければならない。

UI からエージェントまたはツールのエンドポイントを追加するには:

  1. ナビゲーション・メニューから AI Governance > Governed Agentic Catalogの順にクリックし、 New Tool/Agentをクリックする。
  2. フィールドに必要事項を入力し、「 作成 」をクリックします。

エージェントとツールの編集

watsonx.governance UI で、既存のエージェントまたはツールの詳細を更新します:

  1. AI Governance > Governed Agentic Catalogを選択する。

  2. 更新したいエージェントとツールを選択し、 矢印アイコンをクリックして詳細ページを開きます。

  3. 編集可能なフィールドの横にある編集アイコンをクリックします。 更新できる:

    • 概要 」セクションの「 概要 」と「 説明
    • ランタイムパッケージと リモートサービスの依存関係 」セクション
    • コードセクションのツールコード環境変数フレームワーク
  4. ベンチマークメトリック追加 をクリックして、ベンチマークの詳細を追加または修正・更新します:

    • ベンチマーク・データセット
    • メトリック
    • 費用 (該当する場合)
  5. アップデートを保存する。

エージェントまたはツールの削除

現在使用中のエージェントやツールを削除することはできません。 現在使用中のエージェントやツールを削除しようとすると、エラーメッセージが表示されます。

UI でエージェントまたはツールを削除するには、次のようにします:

  1. AI Governance > Governed Agentic Catalogを選択する。

  2. ツールタイルの三点メニュー (↪Sm_22EE) をクリックし、 削除を選択します。

  3. エージェント名とツール名を入力し、 Deleteをクリックして確定します。

注意: ノートブックからツールを削除すると、そのノートブックに関連付けられているエージェントは動作しなくなります。