0 / 0
資料の 英語版 に戻る
エージェントの保存
最終更新: 2025年1月30日
エージェントの保存

Agent LabでAIエージェントを徐々に構築し、エージェントのコアコンポーネントの構成を保存することで開発作業を追跡することができます。

エージェント構成を保存する際、異なる資産として保存することもできます。 作業内容を資産として保存すると、現在のプロジェクトの共同作業者と作業内容を共有できるようになります。

表1:エージェントを保存するために使用される資産
資産タイプ 資産を使用するタイミング 保存されるもの 資産の取得方法
資産 特定のモデルとツールのセットを組み合わせて、希望する結果を生成するエージェントを作成し、そのエージェントを再利用したい場合。 エージェント名と説明( foundation model )、関連パラメータ設定、クイックスタートの質問、モデルの指示、エージェントが使用するツール。
注: The output that is generated by the agent is not saved as part of the Agent asset.
エージェントラボの 「保存されたエージェント」タブから
標準的なノートパソコン資産 エージェントとプログラムで連携したいが、より良いエージェント開発体験を得るために、まずはAgent Labのインターフェースから始めたい場合。 foundation model および関連パラメータ設定、エージェントが使用するツールは、 Python コードとしてフォーマットされ、 Python ノートブックとして保存されます。 プロジェクトの 資産 ページより
配備ノートブック チャットで寄せられた質問に対する回答をグラウンディングから検索するなど、エージェントが高度な機能を行うことができ、その機能をAIサービスとして展開したい場合。 REST APIで利用可能な展開可能なAIサービス。 プロジェクトの 資産 ページより

Each of these asset types is available from the project's 資産 page. Project collaborators with the 管理者 or 編集者 role can open and work with the assets. Your agent asset is locked automatically if you open it in 編集 mode which prevents other users from using it. You can access the agent asset in 下見 mode without locking it.

エージェント開発作業の削減

エージェント開発作業を省略するには、以下の手順を完了してください

  1. エージェントエディタのヘッダーから 、[作業を保存] アイコン 「保存」アイコン をクリックし、 [名前を付けて保存] をクリックします。

  2. 資産を選択してください。

    デプロイ可能なGen AIフローノートブックを作成する場合は、エージェントデプロイメントスペースに関連付ける必要があります。 詳しくは、Deployment spaces を参照してください。

  3. 資産に名前を付け、必要に応じて説明を追加します。

  4. 保存 をクリックします。

ノートブックに保存されたエージェントと連携

When you save your work as a notebook asset, a Python notebook is built.

資産を操作するには、ノートブックの種類に応じた手順に従ってください。

標準ノートブック

  1. Open the notebook asset from the 資産 tab of your project.

  2. 編集アイコン 編集アイコン をクリックしてノートブックをインスタンス化し、コードをステップ実行できるようにします。

    このノートブックには、以下のステップを管理する実行可能なコードが含まれています

    • サービスに認証します。
    • Python クラスを定義します。
    • 選択した foundation model とそのパラメータ、一連のツール、およびエージェントを作成するために使用する指示を定義します。
    • 質問を入力としてエージェントとペアにして作成し、実行することで応答を生成します。
  3. ノートブックをそのまま使用するか、使用事例に合わせて変更してください。

    Agent Labを使用して生成された Python コードは正常に実行されます。 コードに変更を加えた場合は、必ずテストと検証を行う必要があります。

配備ノートブック

  1. Open the notebook asset from the 資産 tab of your project.

  2. 編集アイコン 編集アイコン をクリックしてノートブックをインスタンス化し、コードをステップ実行できるようにします。

    このノートブックには、以下のステップを管理する実行可能なコードが含まれています

    • サービスに認証します。
    • 対象のスペースに接続し、そのデータをAIサービスからアクセスできるように、 資産をプロモーションします。
    • 展開するAIサービスを定義します。 これには、エージェントを作成するコード、エージェント用の入力をフォーマット化するコード、およびエージェントを実行して応答を生成するコードが含まれます。
    • AIサービスをローカルでテストします。
    • 対象のスペースにAIサービスを展開します。
    • デプロイされたAIサービスをテストします。
  3. ノートブックをそのまま使用するか、使用事例に合わせて変更してください。

    Agent Labを使用して生成された Python コードは正常に実行されます。 コードに変更を加えた場合は、必ずテストと検証を行う必要があります。

  4. ノートブックで展開されたAIサービスは、REST APIを使用して利用できます。 The following is an example cURL request to call your deployment:

    curl --location '${PUBLIC_ENDPOINT}' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ${IAM_TOKEN}' \
    --data '{ \
      "messages": [{$MESSAGES}]
    }'
    

    ここで

    • PUBLIC_ENDPOINT は デプロイメントのパブリックエンドポイントです。 オンラインデプロイメントの作成 を参照してください。
    • IAM_TOKENは、 IBM Cloud サービスにアクセスするための認証トークンです。 プログラムによるアクセスについては、認証情報をご覧ください。 使用するアクセストークンは、ノートブックで参照されているプロジェクトと同じアカウントに関連付けられている必要があります。
    • MESSAGESは、以下のスキーマを持つチャット履歴のテキストエントリーの配列です
    {
       "role": type, // "user" or "assistant"
       "content": content // The text content of the message
    }
    

AI サービスのデプロイと推論方法の詳細については、 「ツールを使用した AI サービスのデプロイ」 を参照してください。

保存されたエージェント資産の活用

保存したエージェントで作業を続けるには、エージェントラボの 「保存したエージェント」タブから開きます。

When you open a saved agent, 自動保存 is on, which means that any changes you make to the agent will be reflected in the saved agent asset. 保存したエージェントを変更しない場合は 、「新しいエージェント」 をクリックして新しいエージェントの作成を開始します。

親トピック: エージェントラボ