Benutzerdefinierte Konnektoren

Welche Benutzeroberfläche verwenden Sie?

Diese Dokumentation deckt beide Benutzeroberflächen ab. Wenn Einstellungen → Persönlich → My Okou verfügbar ist, folgen Sie den My Okou-Schritten. Wenn Sie eine Agents-Seite mit Neuer Agent verwenden, folgen Sie den Legacy Agents-Schritten. Die Verfügbarkeit kann je nach Mitglied unterschiedlich sein; diese Dokumente ändern Ihre Benutzeroberfläche nicht.

In beiden Benutzeroberflächen können Sie mehrere Chats oder Aufgaben gleichzeitig ausführen, Workflows wiederverwenden und geprüfte Arbeit mit Ihrem Team teilen. Ein Laufzeit-Subagent ist ein Ausführungstool, kein separates Produktprofil, das Sie erstellen müssen.

Einrichtungsunterschiede: My Okou verwendet persönliche Instructions in Einstellungen → Persönlich → My Okou und Arbeitsbereich-Workflows. Jeder Schritt unten, der Sie auffordert, einen benannten Agenten auszuwählen, zu erstellen oder zu autorisieren, gilt nur für Legacy Agents. In My Okou verwenden Sie Ihren eigenen Chat und folgen der angezeigten Anforderung für Konto und benannte Berechtigungen. Geteilte Workflows geben keine Anmeldedaten weiter; Automations verwenden den Kontext und die Zugriffsrechte ihres Eigentümers.

Ein benutzerdefinierter Konnektor ermöglicht es einem Organisationsadministrator, eine HTTPS-API oder, sofern aktiviert, einen Streamable-HTTP-MCP-Server zu registrieren, der nicht im integrierten Katalog enthalten ist. Er definiert die Netzwerkgrenze und die Authentifizierungsmethode. Er erstellt nicht automatisch eine vollständige API-Referenz für den Agenten.

Wer konfiguriert was

• Organisationsadministratoren erstellen, bearbeiten und löschen die Konnektor-Definition.
• Mitglieder verbinden ihr eigenes Geheimnis oder schließen den OAuth-Ablauf des Konnektors ab.
• Autorisierung und Berechtigungen steuern, welche benannten Aktionen Okou mit der Verbindung anfordern kann. Legacy Agents verwenden außerdem agentenspezifische Autorisierung.

Die Definition wird in der Organisation geteilt. Die Anmeldedaten der Mitglieder bleiben auf das Mitglied und die Organisation beschränkt.

HTTP-API-Konnektor

1. Öffnen Sie Konnektoren → Benutzerdefiniert und wählen Sie Neuer Konnektor.
2. Wählen Sie HTTP-API und geben Sie einen Anzeigenamen ein.
3. Fügen Sie ein oder mehrere HTTPS-Präfixe hinzu, eines pro Zeile. Eine Anfrage muss mit einem konfigurierten Präfix übereinstimmen, bevor der Konnektor sie autorisieren kann.
4. Fügen Sie eine Authentifizierung hinzu, wenn die API sie benötigt:
   • API-Authentifizierung: Geben Sie den Headernamen und eine Header-Vorlage ein, die {{secret}} enthält, zum Beispiel Authorization und Bearer {{secret}}.
   • OAuth 2.0: Geben Sie die Autorisierungs-URL, die Token-URL, die Client-ID, das Client-Geheimnis, die Scopes und die Authentifizierungsmethode des Token-Endpunkts ein. Registrieren Sie die exakt im Formular angezeigte Redirect-URL beim Anbieter.
5. Erstellen Sie den Konnektor. Jedes Mitglied, das ihn benötigt, wählt dann Verbinden und gibt sein Geheimnis ein oder schließt OAuth ab.
6. Prüfen und autorisieren Sie die erforderlichen benannten Berechtigungen. In Legacy Agents wählen Sie außerdem den vorgesehenen Agenten aus.

Wenn Sie eine vorhandene OAuth-Definition oder deren Client-Anmeldedaten ändern, werden bestehende OAuth-Verbindungen getrennt. Mitglieder müssen sich nach der Änderung erneut verbinden.

MCP-Konnektor

Wenn MCP in Ihrem Arbeitsbereich als Konnektortyp angezeigt wird, geben Sie einen HTTPS-Streamable-HTTP-MCP-Endpunkt ein und konfigurieren Sie API- oder OAuth-Authentifizierung im selben Formular. Wenn MCP im Auswahldialog nicht angeboten wird, ist es für diesen Arbeitsbereich nicht aktiviert.

Bringen Sie dem Agenten die API-Prozedur bei

Ein benutzerdefinierter Konnektor bietet sicheren Netzwerkzugriff und das Einfügen von Anmeldedaten. Das Erstellungsformular lädt kein OpenAPI-Dokument hoch und ermittelt es auch nicht automatisch. Geben Sie dem Agenten den Endpunkt, die Methode, die Parameter und die erwartete Antwort in der Anfrage oder halten Sie diese Prozedur in einem Workflow mit einer angehängten API-Referenzdatei fest.

Validieren Sie einen neuen Konnektor mit einer engen, schreibgeschützten Anfrage an einen bekannten Endpunkt. Es gibt keine generische Verbindung testen-Anfrage, da viele APIs keinen aussagekräftigen Root-Endpunkt bereitstellen.

Sicherheitsgrenzen

• Es werden nur HTTPS-Präfixe und MCP-Endpunkte akzeptiert.
• Die Firewall fügt die gespeicherten Anmeldedaten nur in übereinstimmende Anfragen ein.
• Das gespeicherte Geheimnis ist im Ruhezustand verschlüsselt und wird dem Agenten nicht als Umgebungsvariable bereitgestellt.
• Geben Sie keine Schlüssel, Token oder Client-Geheimnisse in Chatnachrichten, Workflow-Anweisungen oder angehängten Dateien ein.
• Verwenden Sie für den Dienst einen Dienstzugang mit den minimalen Upstream-Scopes, die der Workflow benötigt.

Fehlerbehebung

Was kommt als Nächstes

• Siehe Workflows zum Erfassen wiederkehrender Arbeit mit benutzerdefinierten Konnektoren.
• Siehe Berechtigungen, wie Anmeldedaten für benutzerdefinierte Konnektoren gehandhabt werden.
• Siehe den Katalog, bevor Sie etwas Benutzerdefiniertes erstellen – Ihr Dienst wird möglicherweise bereits unterstützt.