Brugerdefinerede connectorer

Hvilken oplevelse bruger du?

Disse dokumenter dækker begge oplevelser. Hvis Indstillinger → Personlig → My Okou er tilgængelig, skal du følge trinnene for My Okou. Hvis du bruger en Agents-side med New agent, skal du følge trinnene for Legacy Agents. Tilgængeligheden kan variere mellem medlemmer; disse dokumenter ændrer ikke din oplevelse.

I begge oplevelser kan du køre flere chats eller opgaver på én gang, genbruge arbejdsgange og dele gennemgået arbejde med dit team. En runtime-subagent er et eksekveringsværktøj, ikke en separat produktprofil, du skal oprette.

Opsætningsforskelle: My Okou bruger personlige Instructions i Indstillinger → Personlig → My Okou og arbejdsområdets arbejdsgange. Ethvert trin nedenfor, der beder dig om at vælge, oprette eller autorisere en navngiven agent, gælder kun for Legacy Agents. I My Okou skal du bruge din egen chat og følge den konto- og navngivne tilladelsesanmodning, der vises. Delte arbejdsgange deler ikke legitimationsoplysninger; Automations bruger ejerens kontekst og adgang.

En brugerdefineret connector giver en organisationsadministrator mulighed for at registrere en HTTPS API eller, hvor det er aktiveret, en Streamable HTTP MCP-server, som ikke findes i det indbyggede katalog. Den definerer netværksgrænsen og godkendelsesmetoden. Den genererer ikke automatisk en komplet API-reference til agenten.

Hvem konfigurerer hvad

Organisationsadministratorer opretter, redigerer og sletter connector-definitionen.
Medlemmer forbinder deres egen hemmelighed eller gennemfører connectorens OAuth-flow.
Autorisation og tilladelser styrer, hvilke navngivne handlinger Okou kan anmode om med forbindelsen. Legacy Agents bruger også agentspecifik autorisation.

Definitionen deles i organisationen. Medlemslegitimationsoplysninger forbliver afgrænset til medlemmet og organisationen.

HTTP API-connector

Åbn Connectors → Custom, og vælg New connector.
Vælg HTTP API, og angiv et visningsnavn.
Tilføj én eller flere HTTPS-Prefixes, én pr. linje. En anmodning skal matche et konfigureret prefix, før connectoren kan autorisere den.
Tilføj godkendelse, hvis API'et har brug for det:
- API authentication: angiv headernavnet og en headermal, der indeholder {{secret}}, for eksempel Authorization og Bearer {{secret}}.
- OAuth 2.0: angiv autorisations-URL'en, token-URL'en, klient-id'et, klienthemmeligheden, scopes og autentificeringsmetoden for token-endpointet. Registrer den nøjagtige omdirigerings-URL, der vises i formularen, hos udbyderen.
Opret connectoren. Hvert medlem, der har brug for den, vælger derefter Connect og angiver sin hemmelighed eller gennemfører OAuth.
Gennemgå og autorisér de påkrævede navngivne tilladelser. I Legacy Agents skal du også vælge den tilsigtede agent.

Hvis du ændrer en eksisterende OAuth-definition eller dens klientlegitimationsoplysninger, afbrydes de nuværende OAuth-forbindelser. Medlemmer skal forbinde igen efter ændringen.

MCP-connector

Hvis MCP vises som en connector-type i dit arbejdsområde, skal du angive et HTTPS Streamable HTTP MCP-endepunkt og konfigurere API- eller OAuth-godkendelse i den samme formular. Hvis MCP ikke tilbydes i vælgeren, er det ikke aktiveret for det arbejdsområde.

Lær agenten API-proceduren

En brugerdefineret connector giver sikker netværksadgang og indsættelse af legitimationsoplysninger. Oprettelsesformularen uploader ikke et OpenAPI-dokument og opdager det heller ikke automatisk. Giv agenten endepunktet, metoden, parametrene og det forventede svar i anmodningen, eller fang den procedure i en arbejdsgang med en API-reference vedhæftet som fil.

Valider en ny connector med en snæver, skrivebeskyttet anmodning til et kendt endepunkt. Der findes ikke en generisk anmodning om Test connection, fordi mange API'er ikke eksponerer et meningsfuldt rod-endepunkt.

Sikkerhedsgrænser

Kun HTTPS-prefixer og MCP-endepunkter accepteres.
Firewallen indsætter kun den gemte legitimationsoplysning i matchende anmodninger.
Den gemte hemmelighed er krypteret i hvile og eksponeres ikke for agenten som en miljøvariabel.
Læg ikke nøgler, tokens eller klienthemmeligheder i chatbeskeder, workflow-instruktioner eller vedhæftede filer.
Brug en servicelegitimation med de minimale upstream-scopes, som workflowet kræver.

Fejlfinding

Problem	Tjek
New connector er ikke tilgængelig	Kun en organisationsadministrator kan oprette eller redigere connector-definitioner.
Agenten kan ikke se connectoren	Forbind den for det aktuelle medlem, og gennemgå de nødvendige tilladelser. I Legacy Agents skal du også autorisere den tilsigtede agent.
Anmodningen blokeres, før den når API'et	Bekræft, at anmodnings-URL'en begynder med et af de konfigurerede HTTPS-prefixer.
API'et returnerer 401 eller 403	Forbind medlemslegitimationsoplysningen igen, og verificer den upstream-nøgle eller de OAuth-scopes, der bruges.
OAuth returnerer en omdirigeringsfejl	Registrer den nøjagtige omdirigerings-URL, der vises i connectorformularen, og verificer autorisations- og token-URL'erne.
Agenten gætter det forkerte endepunkt eller payload	Læg API-proceduren i en arbejdsgang, og vedhæft den relevante reference i stedet for kun at stole på connectornavnet.

Hvad er næste skridt

Se Arbejdsgange for at indfange gentaget arbejde med brugerdefinerede connectorer.
Se Tilladelser for, hvordan legitimationsoplysninger for brugerdefinerede connectorer håndteres.
Se Catalog, før du bygger brugerdefineret — din tjeneste er måske allerede understøttet.