:null

Vilken upplevelse använder du?

De här dokumenten täcker båda upplevelserna. Om Settings → Personal → My Okou är tillgängligt, följ stegen för My Okou. Om du använder en Agents-sida med New agent, följ stegen för Legacy Agents. Tillgängligheten kan skilja sig mellan medlemmar; de här dokumenten ändrar inte din upplevelse.

I båda upplevelserna kan du köra flera chattar eller uppgifter samtidigt, återanvända arbetsflöden och dela granskade resultat med ditt team. En körnings-subagent är ett exekveringsverktyg, inte en separat produktprofil som du behöver skapa.

Skillnader i uppsättning: My Okou använder personliga instruktioner (Instructions) i Settings → Personal → My Okou och arbetsytans Workflows. Varje steg nedan som ber dig välja, skapa eller auktorisera en namngiven Agent gäller bara för Legacy Agents. I My Okou använder du din egen chatt och följer begäran om konto och namngivna behörigheter som visas. Delade Workflows delar inte inloggningsuppgifter; Automations använder sin ägares kontext och åtkomst.

En anpassad koppling låter en organisationsadministratör registrera ett HTTPS-API eller, där det är aktiverat, en Streamable HTTP MCP-server som inte finns i den inbyggda katalogen. Den definierar nätverksgränsen och autentiseringsmetoden. Den genererar inte automatiskt en fullständig API-referens för agenten.

Vem konfigurerar vad

Organisationsadministratörer skapar, redigerar och tar bort kopplingsdefinitionen.
Medlemmar ansluter sin egen hemlighet eller slutför kopplingens OAuth-flöde.
Auktorisering och behörigheter styr vilka namngivna åtgärder Okou kan begära med anslutningen. Legacy Agents använder också agent-specifik auktorisering.

Definitionen delas i organisationen. Medlemmarnas inloggningsuppgifter förblir avgränsade till medlemmen och organisationen.

HTTP API-koppling

Öppna Connectors → Custom och välj New connector.
Välj HTTP API och ange ett visningsnamn.
Lägg till en eller flera HTTPS Prefixes, ett per rad. En begäran måste matcha ett konfigurerat prefix innan kopplingen kan auktorisera den.
Lägg till autentisering om API:t behöver det:
- API authentication: ange rubriknamnet och en rubrikmall som innehåller {{secret}}, till exempel Authorization och Bearer {{secret}}.
- OAuth 2.0: ange auktoriserings-URL, token-URL, klient-ID, klienthemlighet, scopes och autentiseringsmetod för token-slutpunkt. Registrera den exakta omdirigerings-URL som visas i formuläret hos leverantören.
Skapa kopplingen. Varje medlem som behöver den väljer sedan Connect och anger sin hemlighet eller slutför OAuth.
Granska och auktorisera de namngivna behörigheter som krävs. I Legacy Agents väljer du också den avsedda Agenten.

Om du ändrar en befintlig OAuth-definition eller dess klientuppgifter kopplas nuvarande OAuth-anslutningar bort. Medlemmar måste ansluta igen efter ändringen.

MCP-koppling

Om MCP visas som en kopplingstyp i din arbetsyta, ange en HTTPS Streamable HTTP MCP-slutpunkt och konfigurera API- eller OAuth-autentisering i samma formulär. Om MCP inte erbjuds i väljaren är det inte aktiverat för den arbetsytan.

Lär agenten API-proceduren

En anpassad koppling ger säker nätverksåtkomst och injicering av inloggningsuppgifter. Skapandeformuläret laddar inte upp eller upptäcker automatiskt ett OpenAPI-dokument. Ge agenten slutpunkten, metoden, parametrarna och det förväntade svaret i begäran, eller fånga den proceduren i ett arbetsflöde med en API-referens bifogad som en fil.

Validera en ny koppling med en smal, skrivskyddad begäran till en känd slutpunkt. Det finns ingen generell begäran Test connection eftersom många API:er inte exponerar en meningsfull rot-slutpunkt.

Säkerhetsgränser

Endast HTTPS-prefix och MCP-slutpunkter accepteras.
Brandväggen injicerar den sparade inloggningsuppgiften endast i matchande begäranden.
Den sparade hemligheten är krypterad i vila och exponeras inte för agenten som en miljövariabel.
Lägg inte nycklar, token eller klienthemligheter i chattmeddelanden, arbetsflödesinstruktioner eller bifogade filer.
Använd en tjänsteinloggning med de minsta uppströms-rättigheter som behövs av arbetsflödet.

Felsökning

Problem	Kontrollera
New connector är inte tillgänglig	Endast en organisationsadministratör kan skapa eller redigera kopplingsdefinitioner.
Agenten kan inte se kopplingen	Anslut den för den aktuella medlemmen och granska de behörigheter som behövs. I Legacy Agents, auktorisera också den avsedda Agenten.
Begäran blockeras innan den når API:t	Bekräfta att begärans URL börjar med ett av de konfigurerade HTTPS-prefixen.
API:t returnerar 401 eller 403	Anslut medlemmens inloggningsuppgift igen och verifiera nyckeln eller OAuth-scopena hos uppströmssystemet.
OAuth returnerar ett omdirigeringsfel	Registrera den exakta omdirigerings-URL som visas i kopplingsformuläret och verifiera auktoriserings- och token-URL:erna.
Agenten gissar fel slutpunkt eller nyttolast	Lägg API-proceduren i ett arbetsflöde och bifoga den relevanta referensen i stället för att enbart förlita dig på kopplingsnamnet.

Vad händer härnäst

Se Arbetsflöden för att fånga återkommande arbete med anpassade kopplingar.
Se Behörigheter för hur inloggningsuppgifter för anpassade kopplingar hanteras.
Se Catalog innan du bygger anpassat — din tjänst kan redan vara stödd.