Chat-Agent-Gateway

Schluss mit dem Bau von Integrationen. Fang an, Gespräche zu führen.

Sois AI stellt keine Endpunkte bereit, sondern einen Agenten. Du sagst ihm in einfacher Sprache, was du brauchst. Der eigene Agent von Sois liest deine Nachricht, klärt die Details, handelt über deinen gesamten Workspace hinweg und antwortet, sobald er fertig ist.

Das ist der Einstieg für Aufrufer ohne eigene KI: Webhooks, Skripte, Altsysteme und Automatisierungen. Ein Endpunkt, einfache Sprache, und der Agent übernimmt das Denken. Für Aufrufer ohne Agenten macht das eine herkömmliche REST-API mit vielen Endpunkten überflüssig. Es gibt keine Schemata zu lernen, keine Feldzuordnungen zu pflegen, keine Breaking Changes hinterherzujagen. Nur ein Gespräch zwischen deinem System und unserem.

Du hast bereits einen KI-Agenten? Verbinde ihn direkt über den MCP-Server. Das ist der strategische Weg: Dein eigener Claude, ChatGPT, Cursor oder Gemini denkt über die Sois-Tools nach, sodass Sois keine KI für dich aufwendet. Das Chat-Agent-Gateway ist für Aufrufer gedacht, die keinen eigenen Agenten mitbringen.

So funktioniert es

You:    "Create a contact for Jane Doe, CEO of Acme Corp, [email protected]"
Agent:  Contact created. Added to workspace with company Acme Corp.

Eine Nachricht rein. Ein Ergebnis raus. Der Agent von Sois klärt alles dazwischen. Da der Agent das Denken übernimmt, nutzt dieser Weg Sois-KI-Credits.

Drei Wege, die Antwort zu erhalten

Methode Am besten geeignet für
Webhook Lege eine response_url für deinen Key fest. Der Agent liefert das signierte Ergebnis, sobald er fertig ist. Fire and forget.
Polling Prüfe den Status der Unterhaltung jederzeit. Einfach, keine Infrastruktur nötig.
Beides Webhooks als primäre Zustellung, Polling als Fallback. Doppelt hält besser.

Schnellstart

1. Hol dir deine Zugangsdaten in den Einstellungen deines Sois AI Workspace

2. Sende eine Nachricht

curl -X POST "https://your-workspace.sois.ai/api/agent" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Api-Key: sois_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Find all contacts from London"}'

3. Empfange die Antwort über deinen Webhook oder durch Abfragen der Unterhaltung

Was kann der Agent tun?

Alles, was ein Benutzer in Sois AI tun kann:

  • Kontakte suchen, erstellen, aktualisieren und löschen
  • Aufgaben und Zuweisungen verwalten
  • E-Mails verfassen und senden
  • Dateien und Dokumente durchsuchen und organisieren
  • Abteilungen, Teams und Mitglieder abfragen
  • Mit jeder installierten Erweiterung arbeiten
  • Mehrere Aktionen in einer einzigen Unterhaltung kombinieren

Der Agent liest Daten nicht nur, er handelt auch danach. Bitte ihn, "John den Q1-Bericht zu mailen", und er findet den Kontakt, sucht das Dokument, verfasst die E-Mail und sendet sie. Keine Orchestrierung erforderlich.

System-zu-System

Wenn beide Seiten intelligent sind, verhandeln sie. Zwei Sois AI Workspaces, oder jedes andere agentische System, können über das Chat-Agent-Gateway Daten ohne menschliches Zutun austauschen. Keine Feldzuordnung. Keine Middleware. Keine Konnektoren. Nur zwei Agenten, die es untereinander klären.

Dein ERP spricht mit deinem CRM. Sie regeln es. Du bekommst eine Zusammenfassung.

Governance: Was eine Integration tun darf

Das Gateway unterliegt derselben Tool-Governance wie der In-App-Assistent. Jede Aktion, die der Agent ausführen könnte, hat einen von drei Modi, und ein API-Key überschreitet nie die Berechtigungen des Benutzers, dem er gehört.

  • Immer. Sichere Aktionen (Lesevorgänge, routinemäßige Schreibvorgänge) laufen automatisch.
  • Nachfragen. Sensible Aktionen (E-Mails senden, Datensätze löschen, alles, was Geld oder Identität betrifft) erfordern die Zustimmung eines Menschen. Da das Gateway ein Fire-and-forget-Kanal ohne Bildschirmaufsicht ist, läuft eine „Nachfragen"-Aktion standardmäßig nicht.
  • Verweigern. Überall blockiert, auch im Gateway.

Damit eine Integration eine bestimmte sensible Aktion unbeaufsichtigt ausführen darf, autorisieren Sie diese Aktion vorab auf dem Key (Einstellungen, API-Keys, Auto-Genehmigung). Das ist eine einmalige, auditierte Entscheidung bei der Ausgabe des Keys, vergleichbar mit dem Gewähren eines Scopes an eine App. Eine vorab autorisierte „Nachfragen"-Aktion läuft dann für diesen Key automatisch; alles nicht Vorautorisierte wird abgelehnt, und der Agent teilt Ihnen mit, dass eine Autorisierung nötig ist, anstatt vorzugeben, gehandelt zu haben.

Jede abgelehnte Aktion wird an Sie zurückgemeldet, sowohl in der Antwort des Agenten als auch maschinenlesbar in der Webhook-Nutzlast unter governance.tools_blocked (jeder Eintrag enthält die Aktion und den Grund: deny oder ask_unauthorised). So sieht Ihr System genau, was getan wurde und was nicht.

Budget statt Rate Limits. Jeder Key hat ein Dollar-Budget: täglich, monatlich oder insgesamt. Du bestimmst, was jede Integration wert ist. Keine willkürlichen Anfragekontingente. Wenn das Budget aufgebraucht ist, sagt es dir der Agent klar und deutlich.

Bereit? Lies die vollständige Task-Interface-Referenz für die Anfrage- und Webhook-Formate, oder bring deinen eigenen Agenten über den MCP-Server mit.