エージェント オブジェクトなしでエージェントを実行

Snowflake で事前に作成されたエージェント オブジェクトなしで Snowflake Cortex エージェントをインラインで実行し、スレッド ID を使用して複数ターンの会話を続行します。

説明

このアクティビティは Snowflake Cortex エージェントをインラインで実行します。Snowflake で事前に作成されたエージェント オブジェクトは必要ありません。Interact Agent で要求されるように、最初に Snowflake で永続的なエージェントを設定するのではなく、実行時にエージェントの動作を定義する場合に使用します。

また、このアクティビティでは複数ターンの会話もサポートしています。スレッド ID と親メッセージ ID を指定すると、新しい会話を開始するのではなく、既存の会話を続行できます。

アクティビティの使用方法

このアクティビティを Maestro のエージェンティック プロセスで使用するには、以下の手順に従います。

1. キャンバスにサービス タスク要素を追加し、タスクの [ プロパティ ] パネルを開きます。
2. [ 実装 ] セクションの [ アクション ] ドロップダウン リストから、[ 外部エージェントを起動し、待機] を選択します。
3. Snowflake Cortex コネクタを選択します。
4. 既存のコネクションを選択するか、新しいコネクションを作成します。詳細については、 Snowflake Cortex 認証 をご参照ください。
5. [ アクティビティ] から、[ エージェント オブジェクトなしでエージェントを実行] を選択します。
6. 以下の表に示すフィールドを設定します。
7. 開始イベントをサービス タスクに接続し、サービス タスクをキャンバスの終了イベント ノードに接続します。

フィールド

フィールド	説明
スレッド ID	続行する既存の会話スレッドの識別子です。新しい会話を開始するには、空のままにします。
親メッセージ ID	スレッド内で返信するメッセージの ID です。スレッド ID も設定しない限り、このプロパティは無効です。
プロンプト	応答を生成するために指定した最初のテキストまたはクエリです。必須。
ツールの選択	使用する特定のツール名のリストです。[ ツールの選択の種類] が [ ツール] に設定されている場合にのみ有効になります。
ツールの選択の種類	ツールの選択方法を決定します。 [自動 ] はエージェントに決定させる、[ 必須] は エージェントにツールの使用を強制し、[ ツール ] は [ ツールの選択] に記載されているツール名を強制的に使用します。既定値は [自動] です。
モデル	オーケストレーションに使用するモデルです。
応答指示	応答生成の手順。
オーケストレーションの指示	エージェントが計画を行うときに使用されるカスタムの指示。
オーケストレーションの予算 (秒)	オーケストレーションの時間予算 (秒単位)。
オーケストレーションの予算 (トークン)	オーケストレーションのトークン予算。
ツール	この実行でエージェントで利用可能なツールのリストです。各エントリは、ツールの種類、名前、説明、および入力スキーマを定義するツール仕様オブジェクトです。
ツールのリソース	ツールの名前 (実行環境や識別子など) でキーとなる、ツールの構成リソース。

エージェントの出力をプロセス変数に割り当てて、Maestro プロセスの進行状況に影響を与える必要があります。出力のキャプチャと使用に関するガイダンスについては、同じ出力パターンに従いますが、 [ エージェントと対話 ] アクティビティをご覧ください。