Mukautetut liittimet

Mitä käyttökokemusta käytät?

Nämä ohjeet kattavat molemmat käyttökokemukset. Jos Asetukset → Henkilökohtainen → My Okou on käytettävissä, noudata My Okou -vaiheita. Jos käytät Agents-sivua, jossa on New agent, noudata Legacy Agents -vaiheita. Saatavuus voi vaihdella jäsenten välillä; nämä ohjeet eivät muuta käyttökokemustasi.

Kummassakin käyttökokemuksessa voit ajaa useita keskusteluja tai tehtäviä samanaikaisesti, käyttää työnkulkuja uudelleen ja jakaa tarkistettua työtä tiimisi kanssa. Ajonaikainen alialagentti on suorituskyökalu, ei erillinen tuotteen profiili, jota sinun tarvitsee luoda.

Määrityserot: My Okou käyttää henkilökohtaisia Instructions-ohjeita kohdassa Asetukset → Henkilökohtainen → My Okou ja työtilan työnkulkuja (Workflows). Kaikki alla oleva vaihe, jossa sinua pyydetään valitsemaan, luomaan tai valtuuttamaan nimetty agentti, koskee vain Legacy Agents -toimintoa. My Okou:ssa käytä omaa chattia ja noudata näytettyä tilin ja nimetyn käyttöoikeuden pyyntöä. Jaetut työnkulut eivät jaa tunnistetietoja; automaatiot käyttävät omistajansa kontekstia ja käyttöoikeuksia.

Mukautettu liitin antaa organisaation ylläpitäjän rekisteröidä HTTPS API:n tai, jos se on käytössä, Streamable HTTP MCP -palvelimen, joka ei ole sisäänrakennetussa luettelossa. Se määrittää verkon rajan ja todennusmenetelmän. Se ei automaattisesti luo agentille täydellistä API-viitettä.

Kuka määrittää mitä

Organisaation ylläpitäjät luovat, muokkaavat ja poistavat liittimen määritelmän.
Jäsenet yhdistävät oman salaisuutensa tai suorittavat liittimen OAuth-kirjautumisen loppuun.
Valtuutus ja käyttöoikeudet ohjaavat, mitä nimettyjä toimintoja Okou voi pyytää yhteyden kautta. Legacy Agents käyttää lisäksi Agent-kohtaista valtuutusta.

Määritelmä jaetaan organisaatiossa. Jäsenten tunnistetiedot pysyvät jäsenen ja organisaation piirissä.

HTTP API -liitin

Avaa Liittimet → Mukautetut ja valitse New connector.
Valitse HTTP API ja anna näyttönimi.
Lisää yksi tai useampi HTTPS Prefixes, yksi per rivi. Pyynnön on vastattava määritettyä etuliitettä, ennen kuin liitin voi valtuuttaa sen.
Lisää todennus, jos API tarvitsee sitä:
- API authentication: anna otsakkeen nimi ja otsakepohja, joka sisältää {{secret}}, esimerkiksi Authorization ja Bearer {{secret}}.
- OAuth 2.0: anna valtuutus-URL, token-URL, client ID, client secret, scopes ja token-päätetodennuksen menetelmä. Rekisteröi palveluntarjoajalle täsmälleen se uudelleenohjaus-URL, joka näkyy lomakkeessa.
Luo liitin. Jokainen jäsen, joka tarvitsee sitä, valitsee sitten Connect ja antaa salaisuutensa tai suorittaa OAuthin loppuun.
Tarkista ja valtuuta vaaditut nimetyt käyttöoikeudet. Legacy Agentsissa valitse myös tarkoitettu Agent.

Olemassa olevan OAuth-määritelmän tai sen client-tunnistetietojen muuttaminen katkaisee nykyiset OAuth-yhteydet. Jäsenten on yhdistettävä uudelleen muutoksen jälkeen.

MCP-liitin

Jos MCP näkyy liitintyypinä työtilassasi, anna HTTPS Streamable HTTP MCP -päätepiste ja määritä API- tai OAuth-todennus samassa lomakkeessa. Jos MCP ei ole valittavissa, sitä ei ole otettu käyttöön kyseisessä työtilassa.

Opeta agentille API-prosessi

Mukautettu liitin tarjoaa turvallisen verkkoyhteyden ja tunnistetietojen injektoinnin. Luontilomake ei lataa tai tunnista automaattisesti OpenAPI-dokumenttia. Anna agentille päätepiste, metodi, parametrit ja odotettu vastaus pyynnössä, tai tallenna tämä menettely workflow-työnkulkuun, johon on liitetty API-viite tiedostona.

Vahvista uusi liitin suppealla, vain luku -pyynnöllä tunnettuun päätepisteeseen. Yleistä Test connection -pyyntöä ei ole, koska monet API:t eivät tarjoa mielekästä juuripäätepistettä.

Tietoturvarajat

Vain HTTPS-etuliitteet ja MCP-päätepisteet hyväksytään.
Palomuuri lisää tallennetun tunnistetiedon vain vastaaviin pyyntöihin.
Tallennettu salaisuus on salattu levossa, eikä se näy agentille ympäristömuuttujana.
Älä laita avaimia, tunnuksia tai client secret -arvoja chat-viesteihin, työnkulkuohjeisiin tai liitettyihin tiedostoihin.
Käytä palvelun tunnistetietoa, jolla on työnkulun tarvitsemat vähimmät ylävirran scopes-oikeudet.

Vianmääritys

Ongelma	Tarkista
New connector ei ole käytettävissä	Vain organisaation ylläpitäjä voi luoda tai muokata liittimen määritelmiä.
Agentti ei näe liitintä	Yhdistä se nykyiselle jäsenelle ja tarkista tarvittavat käyttöoikeudet. Legacy Agentsissa valtuuta myös tarkoitettu Agent.
Pyyntö estetään ennen kuin se saavuttaa API:n	Varmista, että pyynnön URL alkaa yhdellä määritetyistä HTTPS-etuliitteistä.
API palauttaa 401 tai 403	Yhdistä jäsenen tunnistetieto uudelleen ja varmista ylävirran avain tai OAuth-scopes-oikeudet.
OAuth palauttaa uudelleenohjausvirheen	Rekisteröi täsmälleen sama uudelleenohjaus-URL, joka näkyy liittimen lomakkeessa, ja varmista valtuutus- ja token-URL:t.
Agentti arvaa väärän päätepisteen tai payloadin	Laita API-prosessi työnkulkuun ja liitä asiaankuuluva viite sen sijaan, että luottaisit pelkkään liittimen nimeen.

Mikä seuraavaksi

Katso Työnkulut toistuviin mukautetun liittimen töihin.
Katso Oikeudet nähdäksesi, miten mukautetun liittimen tunnistetietoja käsitellään.
Katso Catalog ennen mukautetun liittimen rakentamista — palvelusi voi jo olla tuettuna.