---
title: "API-yhteydet"
description: "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

<Steps>
  <Step title="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**.
  </Step>
  <Step title="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.
  </Step>
  <Step title="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.
  </Step>
  <Step title="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.
  </Step>
</Steps>

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.

Otsakearvot ovat vain kirjoitettavissa. Tallennuksen jälkeen ne salataan eikä niitä näytetä enää koskaan hallintapaneelissa tai API:ssa. Kun muokkaat yhteyttä, tallennettu otsake näyttää nimensä ja arvon tilalla pisteitä sekä merkinnän **Tallennettu**: jätä se ennalleen säilyttääksesi tallennetun arvon tai korvaa se kirjoittamalla uusi arvo. Testipyynnöt ja reaaliaikaiset puhelut käyttävät tallennettua arvoa. **Kloonaa** kopioi tallennetut arvot uuteen yhteyteen.

<Tip>
  Anna parametreille selkokieliset kuvaukset ("Asiakkaan sähköpostiosoite,
  esim. jane@example.com"). Agentti valitsee argumentit näiden kuvausten
  perusteella reaaliajassa puhelun aikana.
</Tip>

## 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](/fi/guides/build-an-agent)). Luettelosta näet, mitkä agentit
käyttävät kutakin yhteyttä, joten näet yhdellä silmäyksellä, mihin muutos
vaikuttaa.

## Seuraavat vaiheet

<CardGroup cols={2}>
  <Card title="Työkaluintegraatiot API:n kautta" icon="code" href="/fi/guides/build-tool-integration">
    Luo ja hallitse samoja yhteyksiä ohjelmallisesti.
  </Card>
  <Card title="Yhdistä sovelluksia" icon="cable" href="/fi/guides/connect-apps">
    Valmiit yhteydet Googleen, Slackiin, HubSpotiin, Salesforceen ja Cal.comiin.
  </Card>
  <Card title="Lisää MCP-palvelin" icon="server" href="/fi/guides/mcp-servers">
    Tarjoa kokonainen työkalupalvelin agenttiesi käyttöön.
  </Card>
  <Card title="Integraatioiden API-viite" icon="book" href="/api-reference/integrations">
    Integraatioresurssin jokainen kenttä.
  </Card>
</CardGroup>