---
title: "Připojení API"
description: "Proměňte libovolné rozhraní HTTP API na funkci, kterou může váš agent volat uprostřed konverzace: vložte příkaz cURL a průvodce vytvoří definici nástroje, parametry a ověřování."
---

Připojení API jsou vlastní funkce HTTP, které mohou vaši agenti během
konverzace volat — vyhledat objednávku, vytvořit tiket, 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é, je pak mohou vyvolat, kdykoli to konverzace vyžaduje.

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

## Rychlá cesta: vložení a analýza

<Steps>
  <Step title="Klikněte na Nové připojení API">
    Dialogové okno 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é našel. Hlavičky, které jste vložili (včetně
    autentizač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 spustí živý testovací požadavek na váš endpoint. Pokud
    požadavek selže, připojení se neuloží — opravte adresu URL, autentizační
    hlavičky nebo tělo a zkuste to znovu. Po úspěšném ověření se připojení uloží
    s označením **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 se vraťte zpět přes **Chcete,
aby to AI odvodila? Vyzkoušejte průvodce →**). Ruční konfigurátor obsahuje dva editory:

- **Vizuální** — formulářová pole pro zobrazovaný název, název funkce, požadavek
  **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 zadat).
- **JSON** — stejná definice jako nezpracovaný JSON pro vložení nebo přímé
  doladění specifikace nástroje.

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

Hodnoty hlaviček jsou pouze pro zápis. Po uložení jsou zašifrovány a už se nikdy nezobrazí
ani v ovládacím panelu, ani v rozhraní API. Při úpravě připojení se u uložené
hlavičky zobrazí její název s tečkami namísto hodnoty a poznámka **Uloženo**:
ponechte ji beze změny, chcete-li zachovat uloženou hodnotu, nebo zadejte novou
hodnotu, chcete-li ji nahradit. Testovací požadavky a živé hovory používají uloženou hodnotu. **Klonovat** zkopíruje uložené hodnoty
do nového připojení.

<Tip>
  Parametrům dávejte popisy v běžném jazyce („E-mailová adresa zákazníka,
  např. 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ří jej používají.
V nabídce akcí daného řádku můžete:

- **Upravit** — znovu otevřít konfiguraci.
- **Klonovat** — duplikovat jej jako výchozí bod (kopie začne 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, do
  které patříte. Přesunutím se odsud odstraní; agenty, které jej používaly,
  může být nutné překonfigurovat.
- **Smazat** — trvalá akce; agenty používající připojení bude nutné
  překonfigurovat.

## Připojení k agentovi

Přidejte připojení k agentovi v části připojení API v konfigurátoru
([Vytvoření agenta](/cs/guides/build-an-agent)). Seznam zobrazuje, kteří agenti
jednotlivá připojení používají, takže na první pohled uvidíte, čeho se změna týká.

## 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í pro 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>