Connect tools & data

API-yhteydet

Muunna mikä tahansa HTTP-rajapinta funktioksi, jota agenttisi voi kutsua kesken keskustelun: liitä cURL-komento, niin ohjattu toiminto luo työkalun määritelmän, parametrit ja todennuksen.

API-yhteydet ovat mukautettuja HTTP-funktioita, joita agenttisi voivat kutsua keskustelun aikana — hakea tilauksen, luoda tiketin tai noutaa tilin tilan 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ää.

Voit luoda yhteyden kahdella tavalla: liitä jotain, jota ohjattu toiminto voi analysoida, tai määritä yhteys manuaalisesti.

Nopein tapa: liitä ja analysoi#

1. Napsauta Uusi API-yhteys

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

2. Napsauta Analysoi

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

3. Vahvista korostetut kentät

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

4. Validoi ja tallenna

   Tallennus lähettää ensin testipyynnön päätepisteeseesi. Jos pyyntö epäonnistuu, yhteyttä ei tallenneta — korjaa URL-osoite, todennusotsakkeet tai runko ja yritä uudelleen. Onnistuessaan yhteys tallennetaan Validoitu-tunnuksella.

Jos ohjattu toiminto ei löydä liittämästäsi sisällöstä pyynnön URL-osoitetta, se ilmoittaa siitä — lisää täydellinen http(s)-päätepiste ja yritä uudelleen.

Manuaalinen määritys#

Napsauta ohjatussa toiminnossa Määritä manuaalisesti → (tai palaa takaisin valitsemalla Haluatko, että tekoäly päättelee tämän? Kokeile ohjattua toimintoa →). Manuaalisessa määritystyökalussa on kaksi muokkainta:

• Visuaalinen — lomakekentät näyttönimelle, funktion nimelle, pyynnön URL-osoitteelle, metodille (POST, GET, PUT, PATCH, DELETE), mukautetuille otsakkeille ja parametriskeemalle (Lisää ominaisuus jokaiselle argumentille, jonka agentti voi antaa).
• JSON — sama määritelmä raakamuotoisena JSONina työkalumäärityksen liittämistä tai hienosäätöä varten.

Testipyyntö-paneelin (valinnainen) avulla voit lähettää määritetyn pyynnön ennen tallentamista sekä nähdä tilan, viiveen ja vastauksen esikatselun. Validoi ja tallenna suorittaa tämän testin aina ja tallentaa vain, jos se onnistuu.

Hallitse yhteyksiäsi#

Jokaisella yhteysrivillä näkyy sen validointitila — Validoitu, Testaamaton tai Virhe — sen funktion nimi sekä sitä käyttävät agentit. Rivin toimintovalikosta voit:

• Muokata — avata määrityksen uudelleen.
• Kloonata — luoda siitä kopion lähtökohdaksi (kopio on aluksi Testaamaton).
• Versiohistoria — tarkastella aiempia versioita ja palauttaa jonkin niistä muokkaimeen.
• Siirtää — kopioida tai siirtää yhteyden toiseen organisaatioon, johon kuulut. Siirtäminen poistaa sen tästä organisaatiosta; sitä käyttävät agentit saattavat tarvita uudelleenmäärityksen.
• Poistaa — pysyvästi; yhteyttä käyttävät agentit on määritettävä uudelleen.

Liitä se agenttiin#

Lisää yhteys agenttiin rakennustyökalun 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#