> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API-yhteydet

> Muunna mikä tahansa HTTP-rajapinta toiminnoksi, jota agenttisi voi kutsua kesken keskustelun — liitä cURL-komento, niin ohjattu toiminto hoitaa loput.

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

<Steps>
  <Step title="Napsauta Uusi API-yhteys">
    Valintaikkuna avautuu ohjattuun toimintoon. Liitä ruutuun esimerkki
    **cURL-komennosta**, **OpenAPI/Swagger-määrityksestä**, **Postman-viennistä**,
    **TypeScript-rajapinnasta** tai **Zod-skeemasta**.
  </Step>

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

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

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

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.

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

## 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](/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ökalujen integraatiot API:n kautta" icon="code" href="/fi/guides/build-tool-integration">
    Luo ja hallinnoi 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 agenteillesi.
  </Card>

  <Card title="Integraatioiden API-viite" icon="book" href="/api-reference/integrations">
    Kaikki integraatioresurssin kentät.
  </Card>
</CardGroup>