Mukautettu liitin antaa organisaation ylläpitäjän rekisteröidä HTTPS API:n tai, jos sallittu, Streamable HTTP MCP -palvelimen, jota ei löydy sisäänrakennetusta luettelosta. Se määrittää verkon rajan ja todennustavan. Se ei automaattisesti luo täydellistä API-viitettä agentille.
Kuka määrittää mitä
- Organisaation ylläpitäjät luovat, muokkaavat ja poistavat liittimen määritelmän.
- Jäsenet liittävät oman salaisuutensa tai suorittavat liittimen OAuth-prosessin.
- Agentin valtuutus määrittää, mitkä agentit voivat käyttää liitettyä tunnusta ja mitkä nimetyt oikeudet ne saavat.
Määritelmä jaetaan organisaatiossa. Jäsenen tunnukset pysyvät jäsenen ja organisaation rajojen sisällä.
HTTP API -liitin
- Avaa Liittimet → Mukautettu ja valitse Uusi liitin.
- Valitse HTTP API ja anna näyttönimi.
- Lisää yksi tai useampi HTTPS-etuliite, yksi per rivi. Pyynnön on vastattava määritettyä etuliitettä, jotta liitin voi valtuuttaa sen.
- Lisää todennus, jos API sitä vaatii:
- API-todennus: anna otsikon nimi ja otsikkopohja, joka sisältää
{{secret}}, esimerkiksiAuthorizationjaBearer {{secret}}. - OAuth 2.0: anna valtuutus-URL, token-URL, client ID, client secret, oikeudet ja token-päätepisteen todennustapa. Rekisteröi lomakkeessa näytetty tarkka uudelleenohjaus-URL palveluntarjoajalle.
- API-todennus: anna otsikon nimi ja otsikkopohja, joka sisältää
- Luo liitin. Jokainen jäsen, joka tarvitsee sitä, valitsee Yhdistä ja antaa oman salaisuutensa tai suorittaa OAuth-prosessin.
- Valtuuta tarvittava agentti ja oikeudet.
OAuth-määritelmän tai sen client-tunnusten muuttaminen katkaisee nykyiset OAuth-yhteydet. Jäsenten on yhdistettävä uudelleen muutoksen jälkeen.
MCP-liitin
Jos MCP näkyy liitintyyppeinä työtilassasi, anna HTTPS Streamable HTTP MCP -päätepiste ja määritä API- tai OAuth-todennus samalla lomakkeella. Jos MCP ei ole valittavissa, sitä ei ole otettu käyttöön kyseisessä työtilassa.
Opeta agentille API-toimintatapa
Mukautettu liitin tarjoaa turvallisen verkkoyhteyden ja tunnuksen syötön. Luontilomake ei lataa eikä automaattisesti tunnista OpenAPI-dokumenttia. Anna agentille päätepiste, metodi, parametrit ja odotettu vastaus pyynnössä, tai tallenna tämä toimintatapa työnkulkuun, johon on liitetty API-viite tiedostona.
Testaa uusi liitin rajatulla, vain luku -pyynnöllä tunnettuun päätepisteeseen. Yleistä Testaa yhteys -toimintoa ei ole, koska monilla API-rajapinnoilla ei ole merkityksellistä juuripäätepistettä.
Turvarajat
- Vain HTTPS-etuliitteet ja MCP-päätepisteet hyväksytään.
- Palomuuri syöttää tallennetun tunnuksen vain vastaaviin pyyntöihin.
- Tallennettu salaisuus on salattu levossa eikä sitä paljasteta agentille ympäristömuuttujana.
- Älä laita avaimia, tunnuksia tai client secret -tietoja keskusteluviesteihin, työnkulkuohjeisiin tai liitetiedostoihin.
- Käytä palvelutunnusta, jolla on työnkulun tarvitsemat vähimmäisoikeudet.
Vianmääritys
| Ongelma | Tarkista |
|---|---|
| Uusi liitin 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 valtuuta sitten kyseinen agentti. |
| Pyyntö estetään ennen API:lle pääsyä | Varmista, että pyynnön URL alkaa jollakin määritetyistä HTTPS-etuliitteistä. |
| API palauttaa 401 tai 403 | Yhdistä jäsenen tunnus uudelleen ja tarkista ylävirran avain tai OAuth-oikeudet. |
| OAuth palauttaa uudelleenohjausvirheen | Rekisteröi liittimen lomakkeessa näytetty tarkka uudelleenohjaus-URL ja tarkista valtuutus- ja token-URL:t. |
| Agentti arvaa väärän päätepisteen tai sisällön | Laita API-toimintatapa työnkulkuun ja liitä asiaankuuluva viite sen sijaan, että luottaisit pelkkään liittimen nimeen. |
