Skip to main content

Webhookの役割

Shanoneは外部サービスからのインバウンドWebhookイベントを受信し、あなたが既に接続済みのエージェントプラットフォームへタスクとして自動的に引き渡すことができます——自分でWebhookレシーバーを実装・ホスティングする必要はありません。
これは、内部的なスケジュール/定期実行タスクを中心に構築されていた以前の「Automations」というコンセプトを置き換えたものです。現在の実際の実装はイベント駆動型です。Shanoneは自身でスケジューラを実行するのではなく、外部のWebhookイベントに反応して外部エージェントを起動します。

対応するソースとターゲット

ソース

現時点ではTypeform——新しいフォーム送信がWebhookサブスクリプションのトリガーになります

ターゲット

Devin、Cursor Cloud Agents、Manus——それぞれデフォルトのタスクプロンプトを持ち、サブスクリプションごとに上書きできます
どちらのリストもShanoneのバックエンド上でレジストリ管理されているため、既存のサブスクリプションの動作を変えることなく、今後さらにソースやターゲットを追加できます。

Webhookサブスクリプションを設定する

1

サブスクリプションを作成する

エージェントに設定を依頼します——たとえば:「Typeformフォームの新しい送信をDevinにレビューさせるWebhookを作成して」。これにより、Typeform連携のWebhook作成ツールが呼び出され、サブスクリプションが登録され、一意のWebhook URLと署名シークレットが返されます。
2

ダッシュボードで確認する

ShanoneダッシュボードのWebhooksを開くと、サブスクリプションの内容(ソース、フォーム、ターゲットプラットフォーム、有効かどうか)を確認できます。
3

ターゲットプラットフォームとプロンプトを選ぶ

target_platformをdevin、cursor、manusのいずれかに設定します。各プラットフォームには適切なデフォルトプロンプトが用意されていますが、独自のtarget_promptを指定することもできます——Cursor Cloud Agentsの場合はtarget_repositoryの設定も必要です。
4

オン/オフを切り替える

サブスクリプションは削除せずに無効化でき、同じダッシュボード画面から後で再度有効化することもできます。
Webhook自体の作成(Typeform側での登録)は、Typeform連携ツールを介してエージェントとのチャットの中で行われます。Webhooksダッシュボード画面は、すでに存在するサブスクリプション——ターゲットプラットフォーム、プロンプト、有効/無効の状態——を表示・管理するためのものです。

イベント発生時に何が起こるか

1

Shanoneが生のペイロードを受信する

ソース固有のアダプター(現時点ではTypeform)がそれを解析し、要約します。
2

Shanoneがターゲットプラットフォームの設定を確認する

そのサブスクリプションにターゲットが設定されていない場合、Shanoneはイベントの要約をログに記録するだけで処理を終えます——何も自動的に起動されません。
3

Shanoneがターゲットプラットフォームを起動する

ターゲットが設定されている場合、Shanoneはプロンプト(あなたが指定したtarget_prompt、またはプラットフォームのデフォルト)とイベントの要約を組み合わせて構築し、ターゲットプラットフォームにそれを使ってセッションを開始するよう依頼します——例えばDevinのセッションやCursor Cloud Agentsの実行を作成します。
target_platformが設定されていないWebhookサブスクリプションは、意図的に何もしない状態になっています——自動的に何かを起動することは決してありません。これは、ソースを接続しただけで、ターゲットを明示的に設定するまでの間、気づかないうちにエージェントのクレジットを消費し始めることがないようにするための設計です。

これが汎用のタスクスケジューラではない理由

Shanone自身は自律的なプランニング/実行エンジンを動かしていません。Webhooksもこの方針を反映しています。Shanoneの役割はイベントを受け取り、「実際に何かを行う」部分を、あなたが別途接続したエージェントプラットフォーム(Devin、Cursor Cloud Agents、Manus)に委任することであり、タスク自体を実行することではありません。

次のステップ

インテグレーション概要

まずTypeformとターゲットのエージェントプラットフォームを接続する

スキル

ターゲットプラットフォームが従うべき指示を、再利用可能なSkillとして保存する