Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

[Feature Request] Please add webhook-triggered Agent runs — fire-and-forget POST on completion

Offen
  • Stimmt etwas nicht?
#324 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
35/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
typescript
Bereich
api, backend, security

Rechercherichtung

Beginne damit, den im Issue beschriebenen bestehenden Einstiegspunkt für Agent-Ausführungen, Audit-Trail sowie die Durchsetzung von Grants oder Richtlinien zu lokalisieren und zu prüfen. Ordne zu, wie die Konfiguration eingehender und ausgehender Webhooks in diese bestehenden Systeme passen würde, und verwende dann die Abnahmekriterien, um die Fertigstellung zu definieren, einschließlich Validierung, Rate-Limiting, unveränderter Berechtigungen und Audit-Einträgen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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

  1. An administrator can configure an inbound webhook URL for an Agent.
  2. An administrator can configure an outbound webhook URL for an Agent.
  3. POSTing to the inbound webhook triggers a new Agent run with the payload as context.
  4. Completing a run sends a POST to the outbound webhook with run metadata.
  5. All webhook triggers and sends appear in the existing audit trail.
  6. Invalid webhook payloads are rejected with clear error messages.
  7. Webhook-triggered runs respect the Agent's existing grant boundaries.

Suggested name

Webhook Triggers or Event-Driven Agent Runs

Vorherrschende Sprache
TypeScript
Sterne
6.3k
Forks
863
Ø Merge
17 Std. 52 Min.
Gemergte PRs (30 T.)
155

Entwicklungsumgebung

  • Enthält ein Dockerfile oder eine Docker-Compose-Datei
  • Hat eine Pull-Request-Vorlage
  • Kein Beitragsleitfaden

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus CopilotKit/OpenBot

Alle Issues in CopilotKit/OpenBot

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.