[Feature Request] Please add webhook-triggered Agent runs — fire-and-forget POST on completion
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 35/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- typescript
調査の方向性
まず、issue に記載されている既存の Agent 実行エントリポイント、監査証跡、grant またはポリシーの適用を特定して監査します。受信および送信 webhook の設定がこれらの既存システムにどのように適合するかを整理し、その後、受け入れ基準を使って、バリデーション、レート制限、権限を変更しないこと、監査記録を含む完了条件を定義します。
索引モデルが issue の本文から書いたものです。
説明
Problem
OpenBot has persistent coworkers, per-Agent computers, governed tool use, and auditability, but it lacks a simple way to trigger Agent runs from external events or notify external systems when a run completes.
For teams integrating OpenBot into existing workflows (e.g., CI/CD pipelines, monitoring alerts, newsletter automation), there is no way to kick off an Agent run via webhook or receive a notification when a run finishes. This forces manual intervention or polling, which defeats the purpose of autonomous Agents.
Feature request
Add webhook-triggered Agent runs — a fire-and-forget POST endpoint to start a run, and an optional outbound webhook when a run completes. This should be an event-layer feature, not a new scheduling system.
Proposed behaviour
- Allow configuring an inbound webhook URL per Agent that, when POSTed to, triggers a new run with the provided payload as context.
- Allow configuring an outbound webhook URL per Agent that receives a POST when a run completes (success, failure, or refusal).
- Support optional payload templates for outbound webhooks (e.g., include run ID, outcome, transcript summary).
- Validate inbound webhook payloads and show clear errors for malformed requests.
- Preserve all governance settings (grants, policies) for webhook-triggered runs, scoped to the Agent's existing permissions.
- Rate-limit inbound webhooks to prevent abuse (e.g., max 10 runs per minute per Agent).
Required controls
- Disabled by default; enabled per Agent.
- Webhook scope: per-Agent, not per deployment.
- Immutable audit log showing when a webhook triggered a run or was sent on completion.
- Review, edit, and delete controls for webhook URLs.
- Clear separation between webhook payload and runtime state (no arbitrary code execution from payload).
- Never automatically grant additional tools or permissions for webhook-triggered runs — grants are unchanged.
- Configurable allowlist for webhook sources (specific IPs, domains, or any URL).
Why this matters
This would make OpenBot more competitive for teams integrating Agents into existing automation workflows while preserving its core advantages: per-Agent isolation, gateway policy enforcement, and action-level auditability. It would be particularly useful for a self-hosted team that wants to trigger Agents from external events (e.g., "new issue filed", "site downtime detected", "newsletter draft due") without manual intervention.
Acceptance criteria
- An administrator can configure an inbound webhook URL for an Agent.
- An administrator can configure an outbound webhook URL for an Agent.
- POSTing to the inbound webhook triggers a new Agent run with the payload as context.
- Completing a run sends a POST to the outbound webhook with run metadata.
- All webhook triggers and sends appear in the existing audit trail.
- Invalid webhook payloads are rejected with clear error messages.
- Webhook-triggered runs respect the Agent's existing grant boundaries.
Suggested name
Webhook Triggers or Event-Driven Agent Runs
- 主要言語
- TypeScript
- スター
- 6.3k
- フォーク
- 863
- 平均マージ
- 17時間 52分
- マージ済み PR（30日）
- 155
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドなし
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
CopilotKit/OpenBot のほかの issue
-
Wrong key location at startup対応中かも @charan-rathore が今日担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 68/100
CopilotKit/OpenBot#800 ·
メンテナーはふだん 1 日以内に返信
-
setup-learning.ts fails on Windows with "spawn npx.cmd EINVAL"対応中かも @Caldas が 3 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 80/100
CopilotKit/OpenBot#792 ·
メンテナーはふだん 1 日以内に返信
-
難易度 3/5 1〜2日 初心者へのやさしさ 68/100
CopilotKit/OpenBot#804 ·
メンテナーはふだん 1 日以内に返信
-
Five out-of-subject findings from PR #770's tier-3 review (credential-revoking tests, single-user boot gate, OAuth client rotation, shared-use atomicity, untyped server/tests)対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープン
難易度 4/5 1週間以上 初心者へのやさしさ 22/100
CopilotKit/OpenBot#786 ·
メンテナーはふだん 1 日以内に返信
-
server/tests leaks database connections: 55 files open a pool and never close it対応中かも @adamsiwiec1 が 2 日前に担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 70/100
CopilotKit/OpenBot#785 ·
メンテナーはふだん 1 日以内に返信
CopilotKit/OpenBot の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
メンテナーはふだん 1 日以内に返信
-
auth: agent-bearer --manager-call is told to use the MCP instance argument on an ambiguous managerオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 80/100
メンテナーはふだん 1 日以内に返信
-
bug module: playback
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
chthollyphile/folia-major#739 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
agilepathway/label-checker#773 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信