Skip to main content
API-yhteydet ovat mukautettuja HTTP-funktioita, joita agenttisi voivat kutsua keskustelun aikana — hae tilaus, luo tiketti tai nouda tilin tila omasta taustajärjestelmästäsi. Määrität päätepisteen kerran kohdassa Yhteydet → API:t (/dashboard/api-connections); agentit, joihin yhteys on liitetty, voivat sitten kutsua sitä aina, kun keskustelu sitä edellyttää. Yhteyden voi luoda kahdella tavalla: liitä jotain, jota ohjattu toiminto voi analysoida, tai määritä yhteys manuaalisesti.

​
Nopea tapa: liitä ja analysoi

1

Napsauta Uusi API-yhteys

Valintaikkuna avautuu ohjattuun toimintoon. Liitä ruutuun esimerkki cURL-komennosta, OpenAPI/Swagger-määrityksestä, Postman-viennistä, TypeScript-rajapinnasta tai Zod-skeemasta.
2

Napsauta Analysoi

ThunderPhone päättelee koko yhteyden liittämästäsi sisällöstä — URL-osoitteen, menetelmän, otsakkeet ja parametriskeeman, joka johdetaan löydetyistä kyselyparametreista ja pyynnön rungosta. Liittämäsi otsakkeet (myös todennusotsakkeet) siirretään päätepisteen määritykseen.
3

Vahvista korostetut kentät

Päätelty määritys avautuu niin, että arvatut kentät on korostettu tarkistamista varten. Muokkaa nimiä, kuvauksia ja parametrityyppejä, jotta agentti ymmärtää, milloin ja miten funktiota kutsutaan — kuvaus on se, minkä malli lukee.
4

Vahvista ja tallenna

Tallennus suorittaa ensin reaaliaikaisen testipyynnön päätepisteeseesi. Jos pyyntö epäonnistuu, yhteyttä ei tallenneta — korjaa URL-osoite, todennusotsakkeet tai runko ja yritä uudelleen. Onnistuneessa tapauksessa yhteys tallennetaan Vahvistettu-tunnuksella.
Jos ohjattu toiminto ei löydä liittämästäsi sisällöstä pyynnön URL-osoitetta, se ilmoittaa siitä — sisällytä täysi http(s)-päätepiste ja yritä uudelleen.

​
Manuaalinen määritys

Napsauta ohjatussa toiminnossa Määritä manuaalisesti → (tai palaa takaisin valitsemalla Haluatko tekoälyn päättelevän tämän? Kokeile ohjattua toimintoa →). Manuaalisessa rakentajassa on kaksi muokkainta:
  • Visuaalinen — lomakekentät näyttönimelle, funktion nimelle, pyynnön URL-osoitteelle, menetelmälle (POST, GET, PUT, PATCH, DELETE), mukautetuille otsakkeille ja parametriskeemalle (Lisää ominaisuus jokaiselle argumentille, jonka agentti voi antaa).
  • JSON — sama määritys raakana JSON-muodossa työkalumäärityksen liittämistä tai hienosäätöä varten.
Testipyyntö-paneelissa (valinnainen) voit lähettää määritetyn pyynnön ennen tallennusta. Paneeli näyttää tilan, viiveen ja vastauksen esikatselun. Vahvista ja tallenna suorittaa aina tämän testin ja tallentaa vain onnistuneessa tapauksessa.
Anna parametreille selkokieliset kuvaukset (“Asiakkaan sähköpostiosoite, esim. jane@example.com”). Agentti valitsee argumentit näiden kuvausten perusteella reaaliajassa kesken puhelun.

​
Hallitse yhteyksiäsi

Jokaisella yhteysrivillä näkyy sen vahvistustila — Vahvistettu, Testaamaton tai Virhe — funktion nimi ja sitä käyttävät agentit. Rivin toimintovalikosta voit:
  • Muokkaa — avata määrityksen uudelleen.
  • Kloonaa — monistaa yhteyden aloituskohdaksi (kopio on aluksi testaamaton).
  • Versiohistoria — tarkastella aiempia versioita ja palauttaa niistä yhden muokkaimeen.
  • Siirrä — kopioida tai siirtää yhteyden toiseen organisaatioon, johon kuulut. Siirtäminen poistaa sen täältä; sitä käyttävät agentit saattavat vaatia uudelleenmäärityksen.
  • Poista — pysyvä toiminto; yhteyttä käyttävät agentit on määritettävä uudelleen.

​
Liitä se agenttiin

Lisää yhteys agenttiin rakentajan API-yhteydet-osiossa (Rakenna agentti). Luettelosta näet, mitkä agentit käyttävät kutakin yhteyttä, joten näet yhdellä silmäyksellä, mihin muutos vaikuttaa.

​
Seuraavat vaiheet

Työkalujen integraatiot API:n kautta

Luo ja hallinnoi samoja yhteyksiä ohjelmallisesti.

Yhdistä sovelluksia

Valmiit yhteydet Googleen, Slackiin, HubSpotiin, Salesforceen ja Cal.comiin.

Lisää MCP-palvelin

Tarjoa kokonainen työkalupalvelin agenteillesi.

Integraatioiden API-viite

Kaikki integraatioresurssin kentät.