> ## 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.

# Připojení API

> Proměňte libovolné HTTP API ve funkci, kterou může váš agent volat uprostřed konverzace — vložte příkaz cURL a nechte průvodce dokončit zbytek.

Připojení API jsou vlastní funkce HTTP, které mohou vaši agenti volat během
konverzace — vyhledat objednávku, vytvořit tiket nebo načíst stav účtu
z vašeho vlastního backendu. Endpoint definujete jednou v části
**Připojení → API** (`/dashboard/api-connections`); agenti, kteří mají
připojení připojené, ho pak mohou vyvolat, kdykoli to konverzace vyžaduje.

Existují dva způsoby, jak ho vytvořit: vložit něco, co může průvodce analyzovat,
nebo připojení nastavit ručně.

## Rychlý postup: vložit a analyzovat

<Steps>
  <Step title="Klikněte na Nové připojení API">
    Dialog se otevře v průvodci. Do pole vložte ukázkový **příkaz cURL**,
    **specifikaci OpenAPI/Swagger**, **export z Postmanu**, **rozhraní
    TypeScript** nebo **schéma Zod**.
  </Step>

  <Step title="Klikněte na Analyzovat">
    ThunderPhone z vašeho vloženého obsahu odvodí celé připojení — adresu URL,
    metodu, hlavičky a schéma parametrů odvozené z parametrů dotazu
    a těla požadavku, které nalezl. Hlavičky, které jste vložili (včetně
    autorizačních hlaviček), se přenesou do konfigurace endpointu.
  </Step>

  <Step title="Potvrďte zvýrazněná pole">
    Odvozená konfigurace se otevře s odhadnutými poli zvýrazněnými
    ke kontrole. Upravte názvy, popisy a typy parametrů, aby agent
    rozuměl, kdy a jak funkci volat — popis je to, co model čte.
  </Step>

  <Step title="Ověřit a uložit">
    Uložení nejprve provede testovací požadavek na váš endpoint. Pokud
    požadavek selže, připojení se neuloží — opravte adresu URL, autorizační
    hlavičky nebo tělo a zkuste to znovu. Po úspěchu se připojení uloží
    s odznakem **Ověřeno**.
  </Step>
</Steps>

Pokud průvodce ve vloženém obsahu nenajde adresu URL požadavku, upozorní vás na to —
uveďte úplný endpoint `http(s)` a zkuste to znovu.

## Ruční nastavení

V průvodci klikněte na **Nastavit ručně →** (nebo pro návrat na **Chcete, aby to AI odvodila?
Vyzkoušejte průvodce →**). Editor ručního nastavení má dva editory:

* **Vizuální** — formulářová pole pro zobrazovaný název, název funkce, požadovanou
  **URL**, **metodu** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), vlastní
  **hlavičky** a schéma parametrů (**Přidat vlastnost** pro každý
  argument, který může agent poskytnout).
* **JSON** — stejná definice jako nezpracovaný JSON pro vložení nebo přímé doladění
  specifikace nástroje.

Panel **Testovací požadavek** (volitelný) vám umožní odeslat nakonfigurovaný požadavek
před uložením a zobrazí stav, latenci a náhled odpovědi.
**Ověřit a uložit** vždy spustí tento test a uloží pouze při úspěchu.

<Tip>
  Parametrům dávejte srozumitelné popisy („E-mailová adresa zákazníka,
  např. [jane@example.com](mailto:jane@example.com)“). Agent vybírá argumenty z těchto
  popisů v reálném čase během hovoru.
</Tip>

## Správa připojení

Každý řádek připojení zobrazuje stav ověření — **Ověřeno**,
**Netestováno** nebo **Chyba** — název funkce a agenty, kteří ho používají.
V nabídce akcí řádku můžete:

* **Upravit** — znovu otevřít konfiguraci.
* **Klonovat** — duplikovat ho jako výchozí bod (kopie začíná jako
  Netestováno).
* **Historie revizí** — zobrazit dřívější verze a obnovit jednu z nich do
  editoru.
* **Převést** — zkopírovat nebo přesunout připojení do jiné organizace, jejímž
  jste členem. Přesunutím se odsud odstraní; agenti, kteří ho používali, mohou vyžadovat
  novou konfiguraci.
* **Odstranit** — trvalé; agenty používající připojení bude nutné
  znovu nakonfigurovat.

## Připojte ho k agentovi

Přidejte připojení k agentovi v sekci připojení API v editoru
([Vytvoření agenta](/cs/guides/build-an-agent)). Seznam zobrazuje, kteří agenti
používají jednotlivá připojení, takže na první pohled uvidíte, co změna ovlivní.

## Další kroky

<CardGroup cols={2}>
  <Card title="Integrace nástrojů přes API" icon="code" href="/cs/guides/build-tool-integration">
    Vytvářejte a spravujte stejná připojení programově.
  </Card>

  <Card title="Připojení aplikací" icon="cable" href="/cs/guides/connect-apps">
    Předpřipravená připojení ke službám Google, Slack, HubSpot, Salesforce a Cal.com.
  </Card>

  <Card title="Přidání serveru MCP" icon="server" href="/cs/guides/mcp-servers">
    Zpřístupněte svým agentům celý server nástrojů.
  </Card>

  <Card title="Referenční dokumentace API integrací" icon="book" href="/api-reference/integrations">
    Každé pole zdroje integrace.
  </Card>
</CardGroup>