はじめに

このガイドでは、AIP Logic へのアクセス方法、AIP Logic インターフェースの紹介、および Debugger での LLM ブロックの構成とLLM の 思考の連鎖（CoT） の調査によって基本的な Logic 機能のセットアップ方法を説明します。

AIP Logic へのアクセス

AIP Logic には、プラットフォームのワークスペースナビゲーションバーから、または CMD + J（macOS）または CTRL + J（Windows）のクイックサーチショートカットを使用してアクセスできます。別の方法として、ファイルから新しい Logic 機能を作成するには、+新規を選択し、次にAIP Logicを選択します（下図参照）。

AIP Logic を開いた後、新しい Logic ファイルを作成できます。ただし、Logic ファイルはプロジェクトフォルダーに保存する必要があり、ホームフォルダーには保存できません。

アプリケーションインターフェース

AIP Logic のインターフェースには、以下の概念図に左から右に番号が振られた3つの主要なコンポーネントがあります。

1. 入力、ブロック、および出力の設定
2. Debugger
3. 実行パネル

ワークフローの概要

典型的な AIP Logic ワークフローでは、左パネル（1）の 入力（A）、ブロック（B）、および出力（C） を設定した後、実行パネル（3）を使用してサンプル出力を生成します。Logic を実行した後、Debugger（2）で LLM の思考の連鎖（CoT）と出力を生成するまでの LLM の手順を確認できます。また、Debugger と実行パネルを組み合わせて、最終出力を視覚化することもできます。実行パネルでは、最近の Logic の実行を確認し、ユニットテストを作成することができます。右側のサイドバーでは、Automate アプリケーションとの Logic の統合など、さらなる機能を見つけることができます。

入力、ブロック、および出力の設定

AIP を初めて使用するとき、右側に 実行 パネルが表示され、左側には 入力（オブジェクトとそのプロパティを選択するためのオプション）、ブロック（Logic 指示を定義するためのもの）、および 出力（目的の Logic 機能の結果を表す）の3つのタイプのボードが表示されます。1つのブロックからの出力は、後続のブロックにフィードされます。

以下のスクリーンショットは、実行 パネルが折りたたまれた状態での入力、ブロック、および出力の設定エリアを示しています。

入力

AIP Logic は、プリミティブまたはオントロジー内のオブジェクトタイプを含むさまざまな入力を受け取ります。入力ブロック（アプリケーションインターフェースガイド の「A」としてラベル付けされている）で、入力名、タイプ（入力がプリミティブまたはオブジェクトであるかどうか）、およびプリミティブタイプまたはオブジェクトタイプを指定できます。サポートされているプリミティブには、配列、ブール値、日付、倍精度浮動小数点数、単精度浮動小数点数、整数、ロング、ショート、文字列、およびタイムスタンプが含まれます。

ブロック

AIP Logic 機能は、ブロック（アプリケーションインターフェースガイド の「B」としてラベル付けされている）で構成されており、これらは LLM がデータとやり取りする方法を表します。AIP Logic ブロックには、変数の作成、オブジェクトプロパティの取得、および LLM の使用 の3つのタイプがあります。ブロックの出力は、後続のブロックで使用できます。各ブロックのタイプについては、以下の個別のセクションで詳しく説明します。

変数の作成

変数の作成 ブロックは、将来のブロックで使用できる変数を作成します。変数は、配列、ブール値、日付、倍精度浮動小数点数、整数、ロング、文字列、またはタイムスタンプのいずれかのタイプであることができます。

オブジェクトプロパティの取得

オブジェクトプロパティの取得 ブロックは、オブジェクトからプロパティを返します。入力オブジェクトが選択されると、オブジェクトからプロパティを選択できます。

LLM の使用

LLM の使用 ブロックは AIP Logic の中核であり、LLM を使用して Logic ブロックを定義することができます。Logic ブロックは、プロンプト、ツール、および 出力 で構成されています。

プロンプト

プロンプトは、自然言語で記述された LLM の指示です。最も重要な情報（LLM が完了する必要があるタスクの概要など）から始め、LLM が必要とするデータと、ツール を使用するタイミングに関するガイダンスを提供します。プロンプトを作成する際には、LLM が明示的に提供するものにのみアクセスできることに注意してください。

次の仮想プロンプトでは、以前のメール会話から情報を検索して、解決策を求める顧客に対して回答を提供するために LLM を使用します。仮想プロンプトは、タスクの概要から始まります。

あなたは私の苦情ヘルパーエージェントです。入力メールで説明されているような類似のイベントを説明する他のメールを見つけてください。メール本文のみを見てください。過去に効果的だったことに基づいて最善の解決策を判断してください。1つの解決策の推奨事項を返し、すべてのメールからの調査結果を一覧表示しないでください。

次に、プロンプトはクエリするデータを指定します（この場合は、苦情メール、complaint オブジェクトとして表現される）。プロンプトを入力した後、"/" を入力して、分析で使用可能な1つ以上の変数を選択し、LLM にアクセスを提供できます。以下のスクリーンショットでは、メールオブジェクトのプロパティを選択しています。

ツール

ツールは、AIP Logic が LLM にオントロジーを読み書きさせ、実世界の操作を実行するための仕組みです。AIP Logic は、データ、ロジック、アクションの3つのカテゴリーのオントロジー駆動型ツールを活用して、効果的にデータをクエリし、論理操作を実行し、安全にアクションを実行します。

利用可能なツールには以下のものがあります。

• アクションの適用
• 機能の呼び出し
• オブジェクトのクエリ
• 計算ツール

アクションの適用

アクションの適用 ツールは、LLM が アクション を使用してオントロジーを編集できるようにします。LLM が提供されたアクションをいつ使用するかを説明できます。オントロジーに変更を適用する方法の詳細については、以下の Logic 機能を使用してオントロジーの編集を行う を参照してください。

機能の呼び出し

機能の呼び出し ツールを使用すると、LLM が呼び出すことができる関数を選択できます。関数はリポジトリ内でコードで定義されていることも、既存の Logic 関数であることもあります。

オブジェクトのクエリ

オブジェクトのクエリ ツールは、LLM がアクセスできるオブジェクトタイプを指定します。必要に応じて複数のオブジェクトタイプを追加し、LLM がアクセスできるプロパティを指定して、クエリをよりトークン効率的にすることができます。

計算ツール

計算ツール を使用すると、LLM で正確な数学的計算を行うことができます。

出力

各 Logic ブロックに中間出力を定義できます。Logic パスの最後のブロックが Logic 機能の出力であり、アプリケーションインターフェースガイド の「C」としてラベル付けされています。

• ブロック出力： ブロック間で渡される中間出力。ブロックの出力は、後続のブロックで使用するためのプリミティブまたはオブジェクトのいずれかであることができます。

• Logic 機能の出力： 返すことを望む Logic 機能の出力。これは、値（プリミティブまたはオブジェクト）または機能が行ったすべての オントロジー編集のいずれかであることができます。

Debugger

Logic 機能を構成した後、ビューの右側にある 実行 を選択して Logic 機能をテストできます。Logic が実行されると、Debugger が開いて LLM の 思考の連鎖（CoT） が表示されます。

実行パネル

実行 パネルから、Logic を実行して評価したり、最近の実行を確認したりできます。右側のサイドバーでは、ユニットテストを設定し、自動化を実行し、実行履歴を表示できます。

実行 パネルの下部では、最近の実行を選択して、出力とデバッグログを表示することもできます。

ユニットテストアイコン（）を選択して、パフォーマンス評価目的の入力バージョンを保存します。

Logic 機能の使用

Logic 機能は、プラットフォーム内の通常の オブジェクト上の関数（FoO） と同じように使用できます。

• Workshop からアクションを呼び出すことで、Logic 機能をバックに持つアクションを設定できます。

• Logic 機能をバックに持つ Markdown ウィジェットを Workshop に配置することもできます。この場合、Logic 機能からの出力タイプは文字列である必要があります。

• AIP Logic の オントロジー関数 ツールを使用して、他の Logic 関数やオブジェクト上の関数で Logic 機能を呼び出すことができます。

Logic 機能を使用してオントロジーの編集を行う

Logic で機能を実行すると、Debugger でシナリオ内のすべての提案されたオントロジー編集が表示されます。これらの編集は実際には実行されません。オントロジーに編集を適用するには、次のいずれかを行ってください。

• アクションから Logic 機能を呼び出すか、
• 自動化から Logic 機能を呼び出します。Logic ダッシュボードから新しい自動化を作成し始めるには、右側にある Automations オプションを使用できます。

オントロジーを編集できるようにするために、Logic 機能で以下のことを行う必要があります。

1. Logic 機能が呼び出すことができる Use LLM ブロックに アクションの適用ツール を設定します。これにより、LLM がオントロジーを編集できるようになります。
2. Logic 機能の編集が完了したら、保存の隣にある 公開 オプションを見つけて選択し、Logic 機能を公開します。
3. 次に、公開したばかりの Logic 機能 をバックに持つ新しいアクションを作成します。
4. この新しいアクションを Workshop モジュールで使用して、操作ワークフローを実行できるようになります。

次のステップ

AIP Logic へのアクセスがある場合は、LLM ブロックを使用してオントロジーと対話し、独自のユースケースを構築することをお勧めします。プラットフォーム内の 関数 に関するドキュメントを確認すると役立ちます。