Aangepaste connectoren

Welke ervaring gebruikt u?

Deze documentatie behandelt beide ervaringen. Als Instellingen → Persoonlijk → My Okou beschikbaar is, volg dan de stappen voor My Okou. Als u een Agents-pagina met New agent gebruikt, volg dan de stappen voor Legacy Agents. Beschikbaarheid kan per lid verschillen; deze documentatie verandert uw ervaring niet.

In beide ervaringen kunt u meerdere chats of taken tegelijk uitvoeren, workflows hergebruiken en beoordeeld werk delen met uw team. Een runtime-subagent is een uitvoeringshulpmiddel, niet een apart productprofiel dat u hoeft aan te maken.

Setupverschillen: My Okou gebruikt persoonlijke instructies (Instructions) in Instellingen → Persoonlijk → My Okou en werkruimte-workflows. Elke stap hieronder waarin u wordt gevraagd een genoemde Agent te kiezen, aan te maken of te autoriseren, geldt alleen voor Legacy Agents. Gebruik in My Okou uw eigen chat en volg de getoonde verzoeken voor account en benoemde machtiging. Gedeelde workflows delen geen inloggegevens; Automations gebruiken de context en toegang van hun eigenaar.

Met een aangepaste connector kan een org-beheerder een HTTPS-API registreren of, waar ingeschakeld, een Streamable HTTP MCP-server die niet in de ingebouwde catalogus staat. Deze definieert de netwerkgrens en de authenticatiemethode. Er wordt niet automatisch een volledige API-referentie voor de agent gegenereerd.

Wie configureert wat

Org-beheerders maken de connectordefinitie aan, bewerken en verwijderen deze.
Leden koppelen hun eigen geheim of voltooien de OAuth-flow van de connector.
Autorisatie en machtigingen bepalen welke benoemde acties Okou via de verbinding kan aanvragen. Legacy Agents gebruiken daarnaast ook Agent-specifieke autorisatie.

De definitie wordt gedeeld binnen de organisatie. De inloggegevens van leden blijven beperkt tot het lid en de organisatie.

HTTP API-connector

Open Connectors → Custom en kies New connector.
Selecteer HTTP API en voer een weergavenaam in.
Voeg een of meer HTTPS-Prefixes toe, één per regel. Een verzoek moet overeenkomen met een geconfigureerd prefix voordat de connector het kan autoriseren.
Voeg authenticatie toe als de API dit nodig heeft:
- API-authenticatie: voer de headernaam en een headersjabloon in dat {{secret}} bevat, bijvoorbeeld Authorization en Bearer {{secret}}.
- OAuth 2.0: voer de autorisatie-URL, token-URL, client-ID, clientgeheim, scopes en de authenticatiemethode voor het token-eindpunt in. Registreer de exacte omleidings-URL die in het formulier wordt getoond bij de provider.
Maak de connector aan. Elk lid dat deze nodig heeft, kiest daarna Connect en geeft het eigen geheim op of voltooit OAuth.
Controleer en autoriseer de vereiste benoemde machtigingen. Selecteer in Legacy Agents ook de beoogde Agent.

Als u een bestaande OAuth-definitie of de clientgegevens ervan wijzigt, worden bestaande OAuth-verbindingen verbroken. Leden moeten na de wijziging opnieuw verbinding maken.

MCP-connector

Als MCP als connectortype in uw werkruimte verschijnt, voer dan een HTTPS Streamable HTTP MCP-eindpunt in en configureer API- of OAuth-authenticatie in hetzelfde formulier. Als MCP niet wordt aangeboden in de keuzelijst, is het niet ingeschakeld voor die werkruimte.

Leer de agent de API-procedure

Een aangepaste connector biedt veilige netwerktoegang en het injecteren van inloggegevens. Het aanmaakformulier uploadt of herkent geen OpenAPI-document automatisch. Geef de agent het eindpunt, de methode, parameters en verwachte respons in de aanvraag, of leg die procedure vast in een workflow met een API-referentie die als bestand is bijgevoegd.

Valideer een nieuwe connector met een gerichte, alleen-lezen aanvraag naar een bekend eindpunt. Er is geen algemene Test connection-aanvraag, omdat veel API's geen zinvol root-eindpunt bieden.

Beveiligingsgrenzen

Alleen HTTPS-prefixen en MCP-eindpunten worden geaccepteerd.
De firewall injecteert de opgeslagen inloggegevens alleen in overeenkomende aanvragen.
Het opgeslagen geheim is versleuteld in rust en wordt niet als omgevingsvariabele aan de agent blootgesteld.
Plaats geen sleutels, tokens of clientgeheimen in chatberichten, workflow-instructies of bijgevoegde bestanden.
Gebruik een service-inloggegeven met de minimale upstream-scopes die de workflow nodig heeft.

Problemen oplossen

Probleem	Controle
New connector is niet beschikbaar	Alleen een org-beheerder kan connectordefinities maken of bewerken.
De agent kan de connector niet zien	Koppel deze voor het huidige lid en controleer de benodigde machtigingen. In Legacy Agents moet u ook de beoogde Agent autoriseren.
Het verzoek wordt geblokkeerd voordat het de API bereikt	Controleer of de URL van het verzoek begint met een van de geconfigureerde HTTPS-prefixen.
De API geeft 401 of 403 terug	Koppel de inloggegevens van het lid opnieuw en controleer de upstream-sleutel of OAuth-scopes.
OAuth geeft een omleidingsfout terug	Registreer de exacte omleidings-URL die in het connectorformulier wordt getoond en controleer de autorisatie- en token-URL's.
De agent raadt het verkeerde eindpunt of de verkeerde payload	Zet de API-procedure in een workflow en voeg de relevante referentie toe in plaats van alleen op de naam van de connector te vertrouwen.

Wat is de volgende stap

Zie Workflows voor het vastleggen van herhaald werk met aangepaste connectors.
Zie Machtigingen voor hoe inloggegevens van aangepaste connectors worden verwerkt.
Zie de Catalogus voordat u iets aangepast bouwt — uw service wordt mogelijk al ondersteund.