Brugerdefinerede connectorer

En brugerdefineret connector gør det muligt for en organisationsadministrator 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

• Org-admins opretter, redigerer og sletter connector-definitionen.
• Medlemmer forbinder deres egen hemmelighed eller gennemfører connectorens OAuth-flow.
• Agentautorisation styrer, hvilke agenter der kan bruge den tilknyttede legitimationsoplysning, og hvilke navngivne tilladelser de får.

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

HTTP API-connector

1. Åbn Connectorer → Brugerdefineret og vælg Ny connector.
2. Vælg HTTP API og indtast et visningsnavn.
3. Tilføj en eller flere HTTPS-præfikser, ét pr. linje. En anmodning skal matche et konfigureret præfiks, før connectoren kan godkende den.
4. Tilføj godkendelse, hvis API'en kræver det:
   • API-godkendelse: indtast header-navnet og en header-skabelon, der indeholder {{secret}}, for eksempel Authorization og Bearer {{secret}}.
   • OAuth 2.0: indtast autorisations-URL, token-URL, klient-ID, klienthemmelighed, scopes og godkendelsesmetode for token-endpoint. Registrér den nøjagtige omdirigerings-URL, der vises i formularen, hos udbyderen.
5. Opret connectoren. Hvert medlem, der har brug for den, vælger derefter Forbind og indtaster deres hemmelighed eller gennemfører OAuth.
6. Autorisér den nødvendige agent og tilladelser.

Ændring af en eksisterende OAuth-definition eller dens klientlegitimationsoplysninger afbryder nuværende OAuth-forbindelser. Medlemmer skal forbinde igen efter ændringen.

MCP-connector

Hvis MCP vises som en connectortype i dit arbejdsområde, skal du indtaste et HTTPS Streamable HTTP MCP-endpoint og konfigurere API- eller OAuth-godkendelse i 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 leverer sikker netværksadgang og indsættelse af legitimationsoplysninger. Oprettelsesformularen uploader eller autodetekterer ikke et OpenAPI-dokument. Giv agenten endpoint, metode, parametre og forventet svar i anmodningen, eller indfang denne procedure i et workflow med en API-reference vedhæftet som fil.

Valider en ny connector med en snæver, skrivebeskyttet anmodning til et kendt endpoint. Der findes ikke en generisk Test forbindelse-anmodning, da mange API'er ikke har et meningsfuldt root-endpoint.

Sikkerhedsgrænser

• Kun HTTPS-præfikser og MCP-endpoints accepteres.
• Firewall'en 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 servicelegitimationsoplysning med de minimale upstream-scopes, workflowet kræver.

Fejlfinding

Hvad nu

• Se Workflows for at indfange gentaget arbejde med brugerdefinerede connectorer.
• Se Tilladelser for hvordan legitimationsoplysninger til brugerdefinerede connectorer håndteres.
• Se Kataloget, før du bygger brugerdefineret — din tjeneste understøttes måske allerede.