Zum Hauptinhalt springen
Connic

Menschliche Freigaben für Agenten.
In Connic integriert.

Connic pausiert sensible Tool-Aufrufe vor der Ausführung, bis eine Freigabe oder Ablehnung vorliegt. Die Entscheidung erfolgt im Dashboard oder per REST API und wird protokolliert. Bedingungen und Wartefristen legen fest, wann eine Prüfung nötig ist und wie lange der Agent wartet.

Starte kostenlosAusführlichen Artikel lesen
Approvals-Dokumentation lesen

Approvals

Pending
order-handler
stripe.refund
2m ago
customera.smith@acme.com
amount€129.00
reasonduplicate charge

Erst prüfen, dann ausführen

Ein freigabepflichtiger Tool-Aufruf wartet auf eine menschliche Entscheidung. Bei Freigabe setzt Connic die Ausführung fort. Für Ablehnungen ist konfigurierbar, ob der Agent stoppt oder ohne diesen Tool-Aufruf weiterarbeitet.

  1. 01

    Der Agent ruft ein geschütztes Tool auf

    process_refund(amount=129)

  2. 02

    Der Run pausiert

    Der Status wechselt zu Awaiting Approval. Der Agent stoppt, die Anfrage bleibt aktiv.

  3. 03

    Prüfende Personen werden benachrichtigt

    Standardmäßig per E-Mail und In-App. Ein optionaler Webhook leitet an Slack, Teams, PagerDuty oder einen eigenen Workflow weiter.

  4. 04

    Eine Person entscheidet

    Im Dashboard oder per REST API genehmigen oder ablehnen.

  5. 05

    Der Run wird fortgesetzt

    Oder er endet mit der Ablehnungsbegründung. Mit on_rejection: continue passt der Agent stattdessen sein Vorgehen an.

Freigaberegeln direkt in der Agent-Datei

Für aufgeführte Tools ist vor der Ausführung eine menschliche Freigabe erforderlich. Mit einer Bedingung gilt diese Pflicht nur für passende Aufrufe, beispielsweise bei Rückerstattungen über einem festgelegten Betrag.

Einfach
agents/order-handler.yaml (snippet)
approval:
  tools:
    - order_tools.process_refund
  timeout: 600
  message: "This refund requires manager approval."

Jeder Aufruf von order_tools.process_refund pausiert den Run, bis ein Projektmitglied ihn genehmigt.

Bedingt
agents/order-handler.yaml (snippet)
approval:
  tools:
    - order_tools.cancel_order                          # always gated
    - order_tools.process_refund: param.amount > 1000   # conditional
  timeout: 3600
  message: "This action requires manager approval."
  on_rejection: continue

Kleine Rückerstattungen laufen direkt durch, größere pausieren zur Prüfung. Mit on_rejection: continue passt der Agent nach einer Ablehnung stattdessen sein Vorgehen an.

Freigabeanfragen prüfen und entscheiden

Die Übersicht zeigt ausstehende Anfragen mit Agent, Tool, Parametern und Wartezeit. Anfragen können direkt genehmigt oder abgelehnt werden. Weitere Informationen stehen in den Details der jeweiligen Ausführung.

Approvals
4 pending
  • order_tools.process_refundawaiting approval
    on order-manager · order_id=ORD-1234 · amount=129
    2m
  • order_tools.process_refundawaiting approval
    on order-manager · order_id=ORD-1287 · amount=2400
    5m
  • order_tools.cancel_orderawaiting approval
    on order-manager · order_id=ORD-1199 · reason=customer_request
    11m
  • db_deleteawaiting approval
    on support-triage · table=conversations · id=42819
    23m

Jede Entscheidung wird protokolliert

Freigaben und Ablehnungen werden mit Person, Zeitpunkt, Tool und Parametern erfasst. Connic zeigt sie im Audit-Log des Projekts und direkt beim betreffenden Tool-Aufruf im Trace.

Wer entschieden hat

Jede Genehmigung und Ablehnung wird mit der entscheidenden Person und dem Zeitpunkt protokolliert.

Was aufgerufen wurde

Tool-Name und exakte Parameter zum Entscheidungszeitpunkt werden zusammen mit der Aktion erfasst.

Im Run Trace

Approval Events erscheinen auch im Trace des Runs. Wartezeit und prüfende Person stehen direkt neben dem geschützten Tool-Aufruf.

Entdecke weitere Features

Observability

Jeden Schritt und jedes Token nachvollziehen.

Judges

Jeden Run bewerten und Drift früh erkennen.

KI-Governance

Freigabeentscheidungen als Nachweise mit dem KI-System verknüpfen.

Tools

Vordefinierte Tools, eigenes Python oder MCP.

Testing

Assertions und Judges in CI.

Environments

Konfiguration und Secrets je Environment.

Häufig gestellte Fragen

Ein Timeout folgt demselben Pfad wie eine Ablehnung. Mit dem Standard on_rejection: fail endet der Run; mit on_rejection: continue wird er fortgesetzt und der Agent erfährt, dass das Tool nicht ausgeführt wurde. Für Timeouts zählt die gesamte Wartezeit, nicht nur die aktive Ausführungszeit.

Standardmäßig endet der Run bei einer Ablehnung mit dem Status FAILED und der Begründung der prüfenden Person. Mit on_rejection: continue erhält das LLM stattdessen eine Nachricht, dass das Tool nicht ausgeführt wurde. Der Agent kann dann einen anderen Ansatz versuchen, den Nutzer um weitere Angaben bitten oder die Aktion überspringen.

Ja. In der Freigabekonfiguration kann neben dem Tool-Namen eine Bedingung wie 'param.amount > 1000 and not context.is_admin' stehen. Bedingungen lesen Tool-Parameter über param.<key> und Middleware-Werte über context.<key>. Kann der Ausdruck nicht ausgewertet werden, pausiert der Aufruf zur Prüfung. Die Freigabe wird dadurch nicht umgangen.

Standardmäßig erhalten alle Projektmitglieder eine E-Mail und eine In-App-Benachrichtigung. Wiederverwendbare Benachrichtigungskanäle werden unter Projekt Settings → Notifications eingerichtet. Der Bereich Notification Config auf der Approvals-Seite legt fest, welche Mitglieder und Kanäle Anfragen je Agent erhalten. Mögliche Ziele sind Slack, Microsoft Teams, PagerDuty, Webhooks und eigene Freigabeprozesse.

Ja. Approvals lassen sich mit API-Key-Authentifizierung zusammen mit den übrigen Plattform-Endpoints über die REST API auflisten, genehmigen und ablehnen. Das ist nützlich, wenn ein bestehender Approval Workflow in einem anderen System liegt.

Genehmigen und Ablehnen erfordern die Projektberechtigung approvals.decide. Der Owner hat vollständigen Zugriff; andere Mitglieder erhalten Berechtigungen über die ihnen zugewiesenen Berechtigungsgruppen. Für Entscheidungen per API benötigt auch der API Key approvals.decide.