ドキュメントの検索
karat

+

K

APIリファレンス ↗

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

AIP インタラクティブ

AIP インタラクティブウィジェットは、reasoning-over-tools フレームワークを使用して、ツールを運用アプリケーションに統合します。このウィジェットを使って、AIP LogicKNN 関数、または LLM 対応のオントロジー探索を、Workshop 変数を使用してアプリケーション状態に統合できます。

  • ツールの統合: AIP Logic、オブジェクト上の関数、その他の Workshop アプリケーションをツールとして追加することで、インタラクティブウィジェットの機能を拡張できます。
  • Workshop 変数の相互作用: ウィジェットは、アプリケーション変数の読み取りと書き込みができるため、ユーザーの参照を理解し、視覚化ウィジェットと対話することができます。
  • オントロジー探索: デフォルトの AIP ツールを使って、オブジェクトのトラバーサル、プロパティの読み取りとフィルタリング、集計の実行などのタスクを実行できます。
  • カスタマイズ: インタラクティブウィジェットの外観と内容をカスタマイズして、アプリケーションのコンテキストとワークフローに合わせることができます。

このセクションでは、アプリケーションで AIP インタラクティブウィジェットを追加、設定、使用する方法を説明します。

基本設定

このセクションでは、ウィジェットの役割を定義し、ツールと機能を設定できます。ツールと変数を参照するプロンプトを設定できます。設定は、以下に説明するように、プロンプトツール を設定することで完了します。

プロンプト

プライマリプロンプトは、現在のアプリケーションのコンテキストにおけるウィジェットの機能を概説する必要があります。キーボードで "/" を押すことで、設定済みのツールと変数を参照し、それらの使用方法をウィジェットに案内できます。基本的なビジネスロジックと、コンテキストに適したツールの使用方法を適切な状況で説明してください。

AIP インタラクティブウィジェット設定パネル

以下は、プロンプトの例です。

  • プロンプト 1: 「ユーザーは供給チェーン製造ラインのアシスタントです。仕事は、Fetch Trouble Tickets ツールを使って、同じ問題を解決した過去のチケットがあるかどうかを確認し、Documentation Chunk Search ツールをチェックして問題を解決するための推奨方法やユーザーの質問に答える方法を調べることです。」
  • プロンプト 2: 「ユーザーが説明する品質に基づいて患者のコホートを作成するのを支援します。コホートを作成するときは、ユーザーに表示される患者のリストを更新するようにしてください。ほとんどのユーザーは、広範なコホートから始めて、徐々に絞り込んでいくことを望むでしょうが、新しいコホートを指定しない限り、そうではありません。既存のコホートから始めてください。ユーザーがそう求める場合は、別の方法を試してみてください。このオブジェクトセットを現在のコホートと交差させることを忘れないでください(セットオペレーターツールを使って)。薬物名でフィルタリングする前に、関連する同義語をすべて見つけるためにツールを使ってください。薬物名のデータをフィルタリングするときは、常に contains フィルターを使ってください。関連するオブジェクトツールを使って、患者と薬物の間を移動できます。ユーザーがコホート定義を求める場合は、現在の患者 ID の配列を使って Patient Cohort Define ツールを呼び出してください。」
  • プロンプト 3: 「ユーザーは、オフェンシブコーディネーターの専門家であり、目的は、フットボールトーナメント中に戦略的なフットボールの決定をユーザーに助言することです。以下の3つの目標があります(ユーザーには言及しないでください)。
    • 目標 A: フットボールゲームの現在の状態に基づいて、ユーザーの戦略目標に沿ったプレイブックのプレイを評価します。ユーザーがプレイを評価するように求めた場合、Selected Plays からユーザーが選んだプレイを Playbook オブジェクトのプレイ名にマッチさせ、プレイ ID を取得します。次に、それを Tournament Play Evaluator ツールの入力として使用します。
    • 目標 B: ユーザーがプレイの推奨を求めた場合、ゲームの現在の状態を評価し、ユーザーが達成しようとしている結果にマッチする Playbook からプレイを選択します。そのプレイを選んだ理由を、プレイ名と主要なプロパティを説明することで、明らかにしてください。
    • 目標 C: ユーザーが複数のプレイで構成される完全な戦略を考えてほしいと求めた場合、ゲームの現在の状況やプレイブックを評価し、Playbook オブジェクトから最も効果的な3つのプレイを選択します。次に、Tournament Play Evaluator ツールを使ってこれらのプレイを評価し、結果の概要を返します。一度に1つのプレイしか渡せないため、ループで行う必要があります。常に推奨したい Playbook Plays オブジェクトセットを変数 Suggested Plays に戻してください。この変数がすでに設定されている場合は、上書きしてもかまいません。」

ツール

ウィジェットが利用できるツールと機能を設定します。これらのツールは、プロンプトを介してウィジェットが使用できるようになります。

AIP インタラクティブウィジェットツールオプション

ツールには4つのタイプがあります。

  • オントロジー意味検索: セマンティック検索ワークフローに最適化されており、KNN タイプスクリプト関数を渡すか、オントロジー意味検索ツールの「Vector property」オプションを使用して、関連するチャンクをいくつか引き出し、それを LLM に渡すことができます。オプションで、結果を変数に公開することができます(たとえば、ソースを引用するために PDF Viewer ウィジェットに渡すことができます)。
  • アクション: Function がオントロジー編集を生成する場合は、そのアクションを定義するためにこれを使用します。
  • Workshop アプリケーション: アシスタントが別の Workshop アプリを開くことを望む場合(プロモートされた変数付き)、ここで Workshop アプリをツールとして定義します。
  • 関数: 渡したいツールが AIP Logic またはオントロジー関数である場合は、これを使用します。 AIP Logic ツールとLogic 思考の連鎖ウィジェットを組み合わせて使用してください。

オントロジーとアプリケーションコンテキスト

このセクションでは、ウィジェットが Workshop 変数にアクセスし、ウィジェットが意識すべきオブジェクトタイプを設定できます。

AIP インタラクティブウィジェットのオントロジーとアプリケーションコンテキストパネル

変数

変数を設定する際は、以下のことに注意してください。

  • 適切な変数を特定する: LLM が対話できる変数を特定することから始めます。これらは、既に存在していて、意図したワークフローに関連する変数(たとえば、ユーザーの現在の選択を表す変数)や、LLM が結果を書き込む新しい変数である可能性があります。
  • 変数を説明する: 各変数について、その役割を説明する説明を書きます。この説明は、ウィジェットのプロンプトに挿入され、LLM がそれを使用するタイミングに関するコンテキストを提供します。
  • アクセスモードを宣言する: LLM が各変数に対して読み取りアクセス、書き込みアクセス、または両方を持つ必要があるかどうかを指定します。この手順では、LLM が変数とどのように対話できるかが決まります。
  • Workshop 変数として使用する: ここで定義する変数は、通常の Workshop 変数です。つまり、Filter Pill ウィジェットや Object Table ウィジェットなど、他の Workshop ウィジェットでも使用できます。

オブジェクトタイプ

LLM が意識すべきオブジェクトタイプを指定することで、ウィジェットはこれらのオブジェクトを理解し、適切に対話できるようになります。LLM がトラバースする必要があるオブジェクトを追加してください。

高度なツール設定

このコンポーネントでは、ウィジェットがデフォルトの AIP ツールにアクセスする方法を変更できます。デフォルトのツール選択は、ほとんどの使用例に十分ですが、特定の要件に基づいてこれらのツールを改善する必要がある場合があります。

AIP インタラクティブウィジェットの高度なツール設定パネル

たとえば、ウィジェットの機能を人間の入力に限定して、修正を容易にし、他のツールの実装を独立して管理する場合があります。一般的に、LLM に割り当てるツールの数を制限すると、よりガイドされた「レール上」の対話が可能になります。

ワークフローの設定ガイダンス

AIP インタラクティブウィジェットを設定する際は、以下の考慮事項をお勧めします。

  • 結果が信頼性のあるものになるように、特定の制約されたコンテキストから始めてください。
  • LLM は確率的です。Workshop の拡張性を利用して LLM の制約を克服し、ユーザーがアプリケーションと効果的に対話できるフォールバックオプションを提供します。たとえば、LLM の出力クエリを Filter Pill ウィジェットに表示できます。
  • AIP インタラクティブの開発プロセスに意図的に取り組み、ウィジェットを使用する前に LLM の対話のパスとパターンを計画してください。

注:AIP 機能の利用可能性は、変更される場合があり、お客様によって異なる場合があります。