メインコンテンツまでスキップ

エージェント作成

watsonx Workshopで自分だけのAIエージェントを作成、構成し、共有する方法をご紹介します。

AIエージェント作成ガイドでは、watsonx Workshopの「Agent Creator」体験を使ってAIエージェントを構築する、エンドツーエンドのプロセスを順を追って説明します。軽量なアシスタントを作成する場合でも、高度なワークフローや統合を備えたマルチスキルのAIエージェントを作成する場合でも、このガイドでは、すぐに始められるようにステップごとの手順を提供します。

次のことを学びます：

  • AIエージェントのコアとなる詳細と全体的な体験を作成し、構成する
  • 静的および動的な知識ソースを追加して、AIエージェントの根拠を固める
  • 用途に応じて Basic Agents または Skills Agents を構築する
  • 外部API、統合、およびエージェントのワークフローを構成する
  • Podcasts、Client Role Play、Presentations、およびPractice Gymなどの Studio ツールを有効にする
  • IBMの中でAIエージェントをテスト、改善し、共有する

あなたが学ぶこと​

スキル エージェント & インテグレーション​

さまざまなビジネスおよび学習のユースケースに合わせて、AIエージェントを構築・設定する方法を学びます。これには、エージェントの動作の定義、適切な知識ソースでのエージェントの根拠付け（グラウンディング）、プロンプトやワークフローの設定、意図する対象者と成果に合致した体験の設計が含まれます。

動的な知識と文脈​

次の方法で、リアルタイムかつ文脈に基づいた情報によってAIエージェントを強化してください：

  • IBMプロダクトのコンテキスト
  • 業界・セクターの基盤
  • アダプティブ・コンテキスト
  • Web検索

スタジオ体験​

AIを活用したインタラクティブな学習体験を有効にするには、次を含みます：

  • AIが生成する ポッドキャスト
  • クライアントの役割演技 のシミュレーション
  • プレゼンテーション の作成
  • 練習用ジム（Practice Gym） の演習

ステップバイステップガイド​

watsonx WorkshopでAIエージェントを構築するためのステップバイステップのウォークスルーを開始します。このガイドでは、重要な設定の詳細、推奨されるベストプラクティス、および実践的なセットアップ例を取り上げます。これにより、エージェントを効果的に設計・デプロイ・改善するための支援を行います。開発プロセスを加速し、スムーズで拡張性のある実装体験を確実にするために、ぜひご覧ください。

Step 1: Access the AI Creator Space and Provide Basic Agent Details

個人用の Agent Creator スペースに移動し、Create Agent をクリックして開始してください。このレイアウトは、エージェントを構築しながら簡単に作成・テストできるように設計されています。画面左側で各AIを設定し、4つのセクションそれぞれでいつでも、メッセージを送って右側の画面に返答を表示することで、エージェントをテストできます。進行しながらテストすることでエージェントの品質が向上し、ターゲットユーザーにもたらす価値が高まります。

画面左上の 1. Agent Details セクションを展開してください。これで、以下の画面が表示されるはずです。AIエージェントの基本情報を、次を含めてご提供ください：

  • エージェント名：ユーザーに表示される名前。
  • エージェントの目的：AIエージェントがユーザーに対して何を行うのかを説明する短い内容。
  • エージェントの説明：エージェントの仕組みや、ユーザーに何を期待してもらうべきかを、より詳しく説明した内容。
  • タグ：ユーザーが検索でAIエージェントを見つけやすくするための短いキーワード。各タグはカンマで区切ってください。たとえば、Build Pipeline with Products Agent のタグは次のようになります：Pipeline, Demand Generation, Create Pipeline, Create Deals, Lead Generation。

これらの情報は、開始時の新しいセッションでIBMの利用者があなたのAIエージェントを見つけられるようにするため、明確かつ簡潔に提示することが重要です。

Step 2: Define the Agent Data Sources

エージェントが意図した体験を提供し、オーディエンスに対して成果をもたらすために必要な適切なデータを持つことは重要です。このセクションでは、エージェントがアクセスできるデータソースを設定できます。

画面左上の 2. Agent Data Sources セクションを展開してください。以下の画面が表示されるはずです。ここでは、watsonx Workshop に用意されている既存のデータソースを活用するか、自分で作成することができます。AI Agent に提供できるデータには 2 つのカテゴリがあります。

1. 静的ナレッジ​

静的ナレッジとは、ドキュメントやWebページなど、AI Agent に直接提供する情報のことです。この情報はアップロード後に自動的に更新されないため、静的とみなされます。ただし、必要に応じて情報を更新または置き換えるために、いつでもエージェントに戻って変更できます。

静的ナレッジを使用する場合

  • 販売フレームワークやキャンペーン資料など、頻繁に変わらない情報を含むドキュメント。
  • 特定のプロセスや活動に関するベストプラクティスなど、変更頻度が低い情報を含む Web サイト。

静的ナレッジの追加

  • [Add Files] の下で 1 つ以上のドキュメントをアップロードします。サポートされているファイル形式は画面に表示されます。
  • [Add Web Content] の下で [Add] をクリックし、URL を使用して Webページを指定します。参照したい Seismic のファイル URL も含めることができます。

注: パブリッシャーのページは、現時点では Workshop 内でアクセスできないため、現在サポートされていません。

2. 動的ナレッジ​

動的ナレッジとは、頻繁に変化する情報のことです。動的なデータソースに接続すると、AI Agent はユーザーとのやり取り中にリアルタイムで情報を取得できるため、AI Agent 自体を手動で更新しなくても、常に最新の情報にアクセスできます。

動的ナレッジを使用する場合

  • エージェントが現在の情報やリアルタイム情報のために Web を検索する必要がある。
  • コンテンツまたはデータセットが定期的に更新されている。
  • 変化するビジネス、業界、またはクライアントの状況に応じて、エージェントに適応してほしい。

動的ナレッジの追加

  • 特定の IBM 製品に AI Agent を紐づけるには、[Focus on Specific Product?] を Yes に切り替え、ドロップダウン メニューから関連する製品を選択します。これにより、IBM Docs および Seismic のコンテンツを基にした詳細な IBM 製品情報を、エージェントが提供できるようになります。
  • さらに AI Agent をカスタマイズするには、[Focus on Specific Industry?] を Yes に切り替え、関連する Industry と Sector(s) を選択することで、セッションを特定の業界およびセクターに紐づけることができます。
  • ユーザーによる編集を許可するために Editable by users を選択し、設定した製品、業界、セクターの選択をユーザーが変更できるかどうかを制御します。このオプションを有効にすると、すべてのユーザーに対して設定がロックされます。
  • [Web Search] を有効にすると、AI Agent はユーザーとのやり取り中にインターネットからリアルタイム情報を取得できます。
  • [Enable Web Search] の横で [Configure] を選択すると、AI Agent がインターネットをいつ・どのように検索すべきかをカスタマイズできます。エージェントが Web を検索すべきタイミング／すべきでないタイミングを定義し、ユーザーからの依頼に対して AI Agent の応答をさらに精密化するための Web 検索の挙動例を指定することもできます。

Step 3: Create the Agent Behavior

あなたのAIエージェントの振る舞いは、ユーザーとのやり取り、プロンプトへの応答、そして体験全体を通じた会話のガイド方法を決定します。このセクションでは、ユーザーが期待する体験を作るために、エージェントの指示、全体的な振る舞い、挨拶メッセージを定義できます。

画面左上の 3. Agent Behavior セクションを展開してください。すると、下の画面が表示されるはずです。

エージェントの振る舞いには2種類あります。Basic Agent は、単一のマスタープロンプトによって動作する軽量エージェントです。一方、Skills Agent は、より高度なユースケースに向けて、複数の専門スキル、ワークフロー、ツール固有の体験をサポートします。

Basic Agent

Basic Agent は、AIエージェントが体験全体を通じてどのように振る舞い、ユーザーに応答し、会話を導くかを定義する単一のマスタープロンプトによって動作します。Skills Agent とは異なり、Basic Agent は専門スキルやワークフローを使用しません。 Basic Agent を設定するには、3. Agent Behavior セクション内の Basic Agent タブを選択します。 その後、以下を定義できます：

  • Agent Prompt: 詳細なシステムプロンプトを通じて、AIエージェントの全体的なアイデンティティ、目的、スコープ、能力、振る舞い、トーンを定義します。このプロンプトは、AIエージェントがユーザーにどのように応答するかを導く一次の指示セットとして機能します。
  • Greeting Message: ユーザーがAIエージェントとのセッションを開始したときに表示されるメッセージをカスタマイズします。このメッセージは、体験を紹介し、期待値を設定し、ユーザーが始める方法を案内する必要があります。{firstName} 変数を使用して、挨拶メッセージをパーソナライズできます。

Skills Agent

Skills Agent は、マスタープロンプトに複数の専門スキルを組み合わせて、より高度でタスクに特化した体験を提供します。各スキルには、それぞれ独自の振る舞い、ツール、プロンプト、ワークフローを設定できるため、AIエージェントはより幅広いユースケースをサポートできます。 Skills Agent を設定するには、3. Agent Behavior セクション内の Skills Agent タブを選択します。次に、以下を設定できます：

  • Master Prompt: すべてのスキルに適用される基礎となる振る舞い、アイデンティティ、目的、スコープ、トーンを定義します。このプロンプトはAIエージェントの土台となり、スキルが有効化される際に個別のスキルプロンプトがその上に追記されます。

  • Skill Name: スキルの短い、ユーザー向けの名前を定義します。この名前はユーザーに表示され、ルーターがスキルを識別するために使用されます。

  • Description: そのスキルがいつ使われるべきか、またどの種類のリクエストをサポートするよう設計されているかを定義します。この説明は、ルーターがスキルを有効化すべきタイミングを判断するために使用されます。

  • Stream from External Agent: 従来の Skill Prompt および Tools & Data の設定を使う代わりに、スキル体験全体を外部サービスまたはエージェント経由でルーティングします。有効にすると、外部連携がスキルの振る舞いと応答生成を完全に制御します。

Stream from External Agent を使用して、指定した外部エージェントとの間ですべてのメッセージを直接ストリーミングします。もし、このスキルに状況（コンテキスト）を提供するサブエージェントとして外部エージェントを使いたい場合（エージェントがユーザーへの応答文をまだ作成する）、この選択は Off のままにし、下の Tools & Data Sources であなたのエージェントをデータソースとして設定してください。

設定方法：

  • Stream from External Agent を Yes に切り替えます。
  • Configure API を選択します。
  • 以下の統合タイプのいずれかを選択します：
  • External API：カスタム認証、ヘッダー、リクエストボディ、変数を使って、任意のREST APIエンドポイントに直接接続します。
  • A2A Agent：Agent-to-Agent（A2A）対応の外部エージェントエンドポイントに接続します。watsonx Orchestrate や、その他のエージェントベースのシステムで一般的に使用されます。
  • Proxy Agent：SSEサポート付きの IBM Advisor Proxy ストリーミングサービスに接続します。
  • Skill Prompt: スキル固有の振る舞い、指示、スコープ、トーンを定義します。このプロンプトは、スキルが有効化されたときにAIエージェントがどのように振る舞うかを制御します。
  • Tools & Data: スキルで利用可能なツールおよびデータソースを設定します。ユースケースに応じて、以下の機能を有効にできます：
  • Product Context：現在のIBMプロダクトおよびセッションコンテキストへのアクセスを提供
  • Web Search：リアルタイムの外部情報を取得
  • Start Presentation：プレゼンテーションやスライドデッキを生成
  • Start Roleplay：シミュレーションされた営業ロールプレイ会話を開始
  • External API：設定した Skill Prompt と AIエージェントの振る舞いを使い続けながら、追加のコンテキストとして外部APIエンドポイントからデータを取得します。Tools & Data の External API を設定する場合、同じ統合設定が Stream from External Agent に使用されます。ただし、スキルの振る舞いを置き換えるのではなく、APIはスキルが利用できる追加のコンテキストおよびデータソースとして機能します。
    • Start Podcast：セッション内容からポッドキャストを生成
    • Start Practice Gym：インタラクティブな練習問題やシミュレーションを作成
  • User Displayed Prompts: 体験内でクリック可能な提案として表示される、ユーザー向けのプロンプトを定義します。表示される各プロンプトには、ユーザーが選択したときにAIエージェントへ直接送信される、基となるプロンプトを含めることができます。
  • すべての変更が完了したら、Save Skill Draft を選択してスキル設定を保存します。 スキルセクション右上の Add Skill を選択することで、いつでも追加のスキルを追加できます。

Step 4: Configure the Agent Studio Tools

AIエージェント内で利用可能なツールにより、よりインタラクティブで魅力的なユーザー体験を作成できます。このセクションでは、ポッドキャスト、プレゼンテーション、ロールプレイ、練習用エクササイズなど、ユーザーがエージェントのセッション中に利用できるLearning Studioツールを設定できます。

画面左上の4. Agent Toolsセクションを展開してください。これで、下の画面が表示されるはずです。Learning Studio Tools セクションでは、AI Agent セッション中にユーザーが利用できるインタラクティブな体験を設定できます。これらのツールは、ユーザーが体験の中で学習、練習、会話のシミュレーション、コンテンツの生成を行うのに役立ちます。

注：Skills Agent を選択した場合は、Learning Studio Tools をセットアップする前に、すべてのスキルが完全に設定されていることを確認してください。

Podcast

  • Podcast をオンにして、セッションのコンテンツから AI を活用したポッドキャストを生成し、外出先でも学習できるようにします。
  • Set Default Prompt を選択して、ポッドキャスト生成時に使用するデフォルトの指示を設定します。ユーザーはポッドキャストを生成する前に、このプロンプトを編集できます。
  • デフォルトのポッドキャストプロンプトは、AI Agent の領域と想定する学習成果に合わせる必要があります。

Practice Gym

  • Practice Gym をオンにして、クイズ形式の練習セッションにユーザーが参加できるようにし、インタラクティブな出題によって知識を強化します。
  • Configure を選択して、体験中にユーザーがクイズを出されるトピックを定義します。AI Agent に関連する焦点を絞ったトピックを 3〜5 個目安に設定してください。

Roleplay

  • Roleplay をオンにして、ユーザーがシミュレーションされたロールプレイ会話や、プレゼンテーションを基にした練習を行えるようにします。
  • Configure を選択して、ユーザーに提供するロールプレイ体験を選びます。次のいずれかができます。
    • All Default を選択して、すべての標準的なロールプレイの種類を利用可能にする
  • Let Me Choose を選択して、ユースケースに合わせてロールプレイのシナリオをカスタマイズする。
  • Default Roleplay Types の下で、Cold Call や Discovery Call など、利用可能にしたい標準のロールプレイシナリオを選択します。
  • Your Custom Scenarios および Presentation Scenarios の下で、ユーザーがアクセスしたい既存のカスタムロールプレイ体験を選択します。
  • Create new from Learning Studio を選択して、ユースケースに合わせて完全にカスタマイズされたロールプレイシナリオを作成します。
  • カスタムロールプレイシナリオを作成する場合は次を設定します。
  • Interaction type を選択：1 対 1 のロールプレイ体験で AI クライアントと会話する場合は Conversation、ユーザーが独立して行うプレゼンテーションベースの練習セッションの場合は Presentation。
  • Describe your practice scenario の下で、シナリオ、ユーザーの目的、クライアントの状況、AI ペルソナの振る舞い、望ましい学習成果を詳細に説明する指示を入力します。
  • シナリオの説明が完了したら、ロールプレイ体験の設定を続けるために Next を選択します。
  • Lock configuration を有効にして、セッション中にユーザーが利用可能なロールプレイの種類を変更できないようにします。
  • Allow users to create custom roleplay scenarios を有効にして、設定済みのオプションに加えて、ユーザーが自分のロールプレイ体験を作成できるようにします。
  • ロールプレイの設定が完了したら Save を選択します。
  • ロールプレイセッションは、設定されたシナリオとルーブリックに基づいて自動的に採点されます。

Presentation

  • Presentation をオンにして、スライドデッキ、トランスクリプト、AI 生成のプレゼンター動画など、AI を活用したプレゼンテーションをユーザーが生成できるようにします。

Step 5: Test and Share Your Agent

AI Agentを作成したら、画面右側の Interactive Agent Test パネルを使用して体験を検証し、エージェントが意図したとおりに動作することを確認してください。さまざまなプロンプト、ワークフロー、Learning Studioツールをテストして、構成を調整します。

更新が必要な場合は、AI Agent Designフローの該当セクションに戻り、必要に応じて構成を変更してください。AI Agentが満足できる体験になるまで、テストと改善を続けてください。

Finish を選択すると、My Agentsページに戻り、作成した新しいAI Agentが表に表示されます。ここから次のことができます：

  • Update を選択して、AI Agentの構成を変更し続ける。
  • Delete を選択して、AI Agentを削除する。
  • Share を選択して、AI Agentへの共有可能なリンクを生成し、コピーする。 Share を選択すると、AI Agentの共有可能なリンクを含むモーダルが表示されます。このリンクは、プレゼンテーション、Slack、Seismicページ、その他の社内向け有効化資料など、既存のリソースやコラボレーションチャネル全体でコピーして共有できます。

注：現在、AI Agentは生成された共有可能リンクを通じてのみ直接共有できます。このリンクにアクセスできるユーザーは watsonx Workshop のホームページに誘導され、AI Agentとのセッション開始を促されます。ユーザーは、エージェントに関連付けられた設定済みの振る舞い、プロンプト、ツール、またはデータソースを編集したり表示したりすることはできません。各AI Agentには1人の所有者のみが存在するため、今後の更新や構成変更はエージェントの元の作成者によってのみ行う必要があります。