Workato Skillコネクター - ワークフローの開始トリガー(リアルタイム)
ワークフローの開始リアルタイムトリガーは、Workato Agent、MCPクライアント、またはその他のAIシステムがスキルを呼び出すとレシピを実行します。 このトリガーは、呼び出し元が指定する必要のある入力パラメーター、受信が期待される結果スキーマ、およびスキルが受信する任意のタスクメタデータを宣言します。
スキルを作成すると、レシピエディターはデフォルトでワークフローの開始トリガーが設定された状態で開きます。 トリガーを設定した後、そのトリガーを別のトリガーに置き換えて、エージェント呼び出しではなく外部イベントからレシピを実行できます。 トリガーを置き換えると、割り当て済みのGenieおよびMCPサーバーからレシピが削除されます。
入力
| 入力フィールド | 説明 |
|---|---|
| スキルの実行前にユーザー確認を要求しますか。 | エージェントがスキルを実行する前にユーザーに確認を求めるかどうかを選択します。 顧客レコードの更新など、破壊的または影響の大きいアクションを実行するスキルには、このオプションを使用します。 詳細については、ユーザー確認を参照してください。 |
| このスキルはいつ実行する必要がありますか。 | スキルの自然言語による説明を入力します。 AIシステムはこの説明を読み、スキルを呼び出すタイミングを判断します。 AIシステムの視点から記述し、判断に役立つコンテキストを含めます。 ベストプラクティスについては、スキル設計のベストプラクティスを参照してください。 |
| このスキルの実行にはどの入力が必要ですか。 | スキルの実行時に呼び出し元のAIシステムが提供するパラメーターを定義します。 JSONを使用するか、フィールドを手動で追加します。 AIシステムが正しく入力できるように、各フィールドにヒントを追加します。 AIシステムによるファイルパラメーターの処理方法については、ファイル入力セクションを参照してください。 |
| このスキルはどの情報を返しますか。 | このスキルの出力フィールドを定義します。 JSONを使用するか、フィールドを手動で追加します。 すべてのアクションを設定した後、応答を返すアクションでデータピルをこれらのフィールドにマッピングします。 |
| タスクメタデータ | 任意です。 Workato GenieコネクターのGenieにタスクを割り当てアクションとともに使用する場合に、このスキルがエージェントから受信するタスクメタデータを定義します。 Genieに割り当てられたタスクには、顧客IDやチケット番号などのメタデータを含めることができます。 ここで定義する名前は、Genieにタスクを割り当てアクションの名前と完全に一致している必要があります。 |
ファイル入力
入力パラメータースキーマにファイルを追加すると、エージェントは生のバイトではなくファイル参照をスキルに渡します。 コネクターは、その参照を、後続のレシピステップで使用できるname、created、file_contents、file_type、およびsizeデータピルを持つファイルオブジェクトに解決します。
このパターンにより、Slackに添付されたPDFやWorkato GOにドロップされた画像などのアップロードファイルを、エージェントがスキルに渡せるようになります。 また、バイナリコンテンツによってエージェントのコンテキストウィンドウが肥大化することも回避できます。
設定手順については、ファイル入力パラメーターを使用してスキルを作成を参照してください。
出力
| 出力フィールド | 説明 |
|---|---|
| パラメーター | 呼び出し元のAIシステムがこのスキル呼び出しに指定した値。 このオブジェクトのスキーマは、このスキルの実行にはどの入力が必要ですか。入力フィールドで定義されます。 |
| コンテキスト | 呼び出し元のエージェントと、それを呼び出したユーザーに関する情報。 使用可能なサブフィールドについては、コンテキストフィールドを参照してください。 |
| カスタムメタデータ | 呼び出し元のエージェントがこのスキル呼び出しに指定したタスクメタデータ属性。 このオブジェクトのスキーマは、タスクメタデータ入力フィールドで定義されます。 |
コンテキストフィールド
コンテキスト出力フィールドには、呼び出し元のエージェントと、スキルを呼び出したユーザーに関する次の情報が含まれます:
Genie ID
スキルを呼び出したGenieのID。
Genie名
スキルを呼び出したGenieの表示名。
会話ID
スキルが呼び出された会話のID。
通話ID
特定のスキル呼び出しのID。
アプリタイプ
ユーザーがエージェントを呼び出したチャットアプリケーション(SlackやMicrosoft Teamsなど)。
アプリユーザーID
チャットアプリケーション内のユーザーのID。
ユーザーID
ユーザーのWorkatoユーザーID。
ユーザー名
ユーザーのフルネームです。
ユーザーのメールアドレス
ユーザーのメールアドレス。
ユーザーグループID
ユーザーが属するWorkatoユーザーグループID。
これらのフィールドを使用して、スキルの動作をパーソナライズしたり、コンテキスト対応の認可を適用したりできます。 たとえば、ユーザーグループIDを使用して、グループメンバーシップに基づいて破壊的なアクションを制限できます。
最終更新日: