Egendefinerte tilkoblinger

Hvilken opplevelse bruker du?

Denne dokumentasjonen dekker begge opplevelsene. Hvis Innstillinger → Personlig → My Okou er tilgjengelig, følger du trinnene for My Okou. Hvis du bruker en Agents-side med New agent, følger du trinnene for Legacy Agents. Tilgjengeligheten kan variere mellom medlemmer; denne dokumentasjonen endrer ikke opplevelsen din.

I begge opplevelsene kan du kjøre flere chatter eller oppgaver samtidig, gjenbruke arbeidsflyter og dele gjennomgått arbeid med teamet ditt. En subagent i kjøretid er et utførelsesverktøy, ikke en separat produktprofil du må opprette.

Forskjeller i oppsett: My Okou bruker personlige Instructions i Innstillinger → Personlig → My Okou og arbeidsområdets arbeidsflyter. Alle trinn nedenfor som ber deg velge, opprette eller autorisere en navngitt agent, gjelder bare for Legacy Agents. I My Okou bruker du din egen chat og følger kontoen og forespørselen om navngitt tillatelse som vises. Delte arbeidsflyter deler ikke legitimasjon; automasjoner bruker eierens kontekst og tilgang.

En egendefinert tilkobling lar en organisasjonsadministrator registrere et HTTPS-API eller, der det er aktivert, en Streamable HTTP MCP-server som ikke finnes i den innebygde katalogen. Den definerer nettverksgrensen og autentiseringsmetoden. Den genererer ikke automatisk en fullstendig API-referanse for agenten.

Hvem konfigurerer hva

Organisasjonsadministratorer oppretter, redigerer og sletter definisjonen av tilkoblingen.
Medlemmer kobler til sin egen hemmelige nøkkel eller fullfører tilkoblingens OAuth-flyt.
Autorisasjon og tillatelser styrer hvilke navngitte handlinger Okou kan be om med tilkoblingen. Legacy Agents bruker også agentspesifikk autorisasjon.

Definisjonen deles i organisasjonen. Medlemslegitimasjon forblir avgrenset til medlemmet og organisasjonen.

HTTP API-tilkobling

Åpne Tilkoblinger → Egendefinerte og velg Ny tilkobling.
Velg HTTP API og skriv inn et visningsnavn.
Legg til ett eller flere HTTPS-prefikser, ett per linje. En forespørsel må matche et konfigurert prefiks før tilkoblingen kan autorisere den.
Legg til autentisering hvis API-et trenger det:
- API-autentisering: skriv inn navn på overskriften og en overskriftsmal som inneholder {{secret}}, for eksempel Authorization og Bearer {{secret}}.
- OAuth 2.0: skriv inn autorisasjons-URL, token-URL, klient-ID, klienthemmelighet, omfang og autentiseringsmetode for tokenendepunktet. Registrer den nøyaktige viderekoblings-URL-en som vises i skjemaet, hos leverandøren.
Opprett tilkoblingen. Hvert medlem som trenger den, velger deretter Koble til og oppgir sin hemmelighet eller fullfører OAuth.
Se gjennom og autoriser de nødvendige navngitte tillatelsene. I Legacy Agents velger du også den tiltenkte agenten.

Hvis du endrer en eksisterende OAuth-definisjon eller klientlegitimasjonen, kobles eksisterende OAuth-tilkoblinger fra. Medlemmene må koble til igjen etter endringen.

MCP-tilkobling

Hvis MCP vises som en tilkoblingstype i arbeidsområdet ditt, skriv inn et HTTPS Streamable HTTP MCP-endepunkt og konfigurer API- eller OAuth-autentisering i det samme skjemaet. Hvis MCP ikke tilbys i velgeren, er det ikke aktivert for det arbeidsområdet.

Lær agenten API-prosedyren

En egendefinert tilkobling gir sikker nettverkstilgang og innsetting av legitimasjon. Opprettelsesskjemaet laster ikke opp eller oppdager automatisk et OpenAPI-dokument. Gi agenten endepunktet, metoden, parameterne og forventet svar i forespørselen, eller fang opp den prosedyren i en arbeidsflyt med en API-referanse vedlagt som fil.

Valider en ny tilkobling med en smal, skrivebeskyttet forespørsel til et kjent endepunkt. Det finnes ingen generell Test connection-forespørsel fordi mange API-er ikke har noe meningsfullt rotendepunkt.

Sikkerhetsgrenser

Bare HTTPS-prefikser og MCP-endepunkter godtas.
Brannmuren setter inn den lagrede legitimasjonen bare i samsvarende forespørsler.
Den lagrede hemmeligheten er kryptert i hvile og eksponeres ikke for agenten som en miljøvariabel.
Ikke legg nøkler, tokener eller klienthemmeligheter i chatmeldinger, arbeidsflytinstruksjoner eller vedlagte filer.
Bruk en tjenestelegitimasjon med de minimale oppstrømsomfangene som arbeidsflyten trenger.

Feilsøking

Problem	Sjekk
Ny tilkobling er utilgjengelig	Bare en organisasjonsadministrator kan opprette eller redigere definisjoner av tilkoblinger.
Agenten kan ikke se tilkoblingen	Koble den til for det aktuelle medlemmet, og gjennomgå tillatelsene som trengs. I Legacy Agents må du også autorisere den tiltenkte agenten.
Forespørselen blokkeres før den når API-et	Bekreft at forespørsels-URL-en begynner med ett av de konfigurerte HTTPS-prefiksene.
API-et returnerer 401 eller 403	Koble til medlemslegitimasjonen på nytt og bekreft den oppstrøms nøkkelen eller OAuth-omfangene.
OAuth returnerer en viderekoblingsfeil	Registrer den nøyaktige viderekoblings-URL-en som vises i tilkoblingsskjemaet, og bekreft autorisasjons- og token-URL-ene.
Agenten gjetter feil endepunkt eller nyttelast	Legg API-prosedyren i en arbeidsflyt og legg ved den relevante referansen i stedet for å stole bare på navnet på tilkoblingen.

Hva skjer videre

Se Arbeidsflyter for å fange opp gjentatt arbeid med egendefinerte tilkoblinger.
Se Tillatelser for hvordan legitimasjon for egendefinerte tilkoblinger håndteres.
Se Katalogen før du bygger noe egendefinert — tjenesten din kan allerede være støttet.