---
title: "Pripojenia API"
description: "Premeňte akékoľvek HTTP API na funkciu, ktorú môže váš agent volať uprostred konverzácie: vložte príkaz cURL a sprievodca vytvorí definíciu nástroja, parametre a autentifikáciu."
---

Pripojenia API sú vlastné funkcie HTTP, ktoré môžu vaši agenti volať počas
konverzácie — vyhľadať objednávku, vytvoriť ticket, načítať stav účtu
z vášho vlastného backendu. Endpoint definujete raz v časti
**Pripojenia → API** (`/dashboard/api-connections`); agenti s pripojeným
pripojením ho potom môžu vyvolať vždy, keď si to konverzácia vyžaduje.

Môžete ho vytvoriť dvoma spôsobmi: vložiť niečo, čo sprievodca dokáže analyzovať,
alebo pripojenie nastaviť manuálne.

## Rýchly postup: vloženie a analýza

<Steps>
  <Step title="Kliknite na Nové pripojenie API">
    Dialógové okno sa otvorí v sprievodcovi. Do poľa vložte ukážkový
    **príkaz cURL**, **špecifikáciu OpenAPI/Swagger**, **export z Postmanu**,
    **rozhranie TypeScript** alebo **schému Zod**.
  </Step>
  <Step title="Kliknite na Analyzovať">
    ThunderPhone z vášho vloženého obsahu odvodí celé pripojenie — URL,
    metódu, hlavičky a schému parametrov odvodenú z parametrov dopytu
    a tela požiadavky, ktoré našiel. Hlavičky, ktoré ste vložili (vrátane
    autorizačných hlavičiek), sa prenesú do konfigurácie endpointu.
  </Step>
  <Step title="Potvrďte zvýraznené polia">
    Odvodená konfigurácia sa otvorí s predpokladanými poľami zvýraznenými
    na kontrolu. Upravte názvy, popisy a typy parametrov, aby agent rozumel,
    kedy a ako má funkciu volať — popis je to, čo číta model.
  </Step>
  <Step title="Overiť a uložiť">
    Uloženie najprv spustí reálnu testovaciu požiadavku na váš endpoint. Ak
    požiadavka zlyhá, pripojenie sa neuloží — opravte URL, autorizačné
    hlavičky alebo telo a skúste to znova. Po úspechu sa pripojenie uloží
    s odznakom **Overené**.
  </Step>
</Steps>

Ak sprievodca vo vloženom obsahu nenájde URL požiadavky, upozorní vás na to —
uveďte úplný endpoint `http(s)` a skúste to znova.

## Manuálne nastavenie

V sprievodcovi kliknite na **Nastaviť manuálne →** (alebo sa vráťte kliknutím na
**Chcete, aby to AI odvodila? Vyskúšajte sprievodcu →**). Manuálny nástroj má dva editory:

- **Vizuálny** — polia formulára pre zobrazovaný názov, názov funkcie, požiadavkovú
  **URL**, **metódu** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), vlastné
  **hlavičky** a schému parametrov (**Pridať vlastnosť** pre každý
  argument, ktorý môže agent zadať).
- **JSON** — rovnaká definícia ako nespracovaný JSON na vloženie alebo priame
  doladenie špecifikácie nástroja.

Panel **Testovacia požiadavka** (voliteľný) vám umožní odoslať nakonfigurovanú
požiadavku pred uložením a zobrazí stav, latenciu a náhľad odpovede.
**Overiť a uložiť** vždy spustí tento test a uloží len pri úspechu.

<Tip>
  Parametrom pridajte jednoducho formulované popisy („E-mailová adresa zákazníka,
  napr. jane@example.com“). Agent vyberá argumenty z týchto
  popisov v reálnom čase počas hovoru.
</Tip>

## Správa pripojení

Každý riadok pripojenia zobrazuje stav overenia — **Overené**,
**Neotestované** alebo **Chyba** — názov funkcie a agentov, ktorí ho používajú.
V ponuke akcií riadku môžete:

- **Upraviť** — znova otvoriť konfiguráciu.
- **Klonovať** — duplikovať ho ako východiskový bod (kópia má na začiatku
  stav **Neotestované**).
- **História revízií** — zobraziť staršie verzie a jednu z nich obnoviť v
  editore.
- **Preniesť** — skopírovať alebo presunúť pripojenie do inej organizácie,
  ktorej ste členom. Presunom ho odtiaľto odstránite; agentov, ktorí ho
  používali, možno bude nutné prekonfigurovať.
- **Odstrániť** — trvalé odstránenie; agentov používajúcich pripojenie bude
  nutné prekonfigurovať.

## Pripojte ho k agentovi

Pridajte pripojenie k agentovi v sekcii Pripojenia API nástroja na vytváranie
agentov ([Vytvorenie agenta](/sk/guides/build-an-agent)). Zoznam zobrazuje, ktorí agenti
používajú jednotlivé pripojenia, takže na prvý pohľad zistíte, čo zmena ovplyvní.

## Ďalšie kroky

<CardGroup cols={2}>
  <Card title="Integrácie nástrojov cez API" icon="code" href="/sk/guides/build-tool-integration">
    Programovo vytvárajte a spravujte rovnaké pripojenia.
  </Card>
  <Card title="Pripojenie aplikácií" icon="cable" href="/sk/guides/connect-apps">
    Predpripravené pripojenia pre Google, Slack, HubSpot, Salesforce a Cal.com.
  </Card>
  <Card title="Pridanie servera MCP" icon="server" href="/sk/guides/mcp-servers">
    Sprístupnite svojim agentom celý server nástrojov.
  </Card>
  <Card title="Referenčná dokumentácia API integrácií" icon="book" href="/api-reference/integrations">
    Každé pole v zdroji integrácie.
  </Card>
</CardGroup>