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

# Połączenia API

> Zamień dowolne API HTTP w funkcję, którą Twój agent może wywołać w trakcie rozmowy — wklej polecenie cURL, a kreator zrobi resztę.

Połączenia API to niestandardowe funkcje HTTP, które Twoi agenci mogą wywoływać podczas
rozmowy — wyszukiwać zamówienie, tworzyć zgłoszenie, pobierać status konta
z własnego backendu. Definiujesz endpoint tylko raz w sekcji
**Połączenia → API** (`/dashboard/api-connections`); agenci z dołączonym
połączeniem mogą następnie wywoływać je zawsze, gdy wymaga tego rozmowa.

Możesz utworzyć połączenie na dwa sposoby: wkleić coś, co kreator może przeanalizować,
albo skonfigurować połączenie ręcznie.

## Szybka ścieżka: wklej i przeanalizuj

<Steps>
  <Step title="Kliknij Nowe połączenie API">
    Okno dialogowe otworzy się w kreatorze. Wklej przykładowe **polecenie cURL**,
    **specyfikację OpenAPI/Swagger**, **eksport Postman**, **interfejs TypeScript**
    lub **schemat Zod** do pola.
  </Step>

  <Step title="Kliknij Analizuj">
    ThunderPhone wywnioskuje całe połączenie na podstawie wklejonych danych — adres URL,
    metodę, nagłówki oraz schemat parametrów utworzony na podstawie znalezionych
    parametrów zapytania i treści żądania. Wklejone nagłówki (w tym
    nagłówki uwierzytelniania) zostaną przeniesione do konfiguracji endpointu.
  </Step>

  <Step title="Potwierdź wyróżnione pola">
    Wywnioskowana konfiguracja otworzy się z wyróżnionymi
    polami sugerowanymi do sprawdzenia. Dostosuj nazwy, opisy i typy
    parametrów, aby agent wiedział, kiedy i jak wywołać funkcję — opis
    jest tym, co odczytuje model.
  </Step>

  <Step title="Zweryfikuj i zapisz">
    Zapisanie najpierw uruchamia rzeczywiste testowe żądanie do Twojego endpointu. Jeśli
    żądanie się nie powiedzie, połączenie nie zostanie zapisane — popraw adres URL, nagłówki
    uwierzytelniania lub treść i spróbuj ponownie. Po powodzeniu połączenie zostanie zapisane
    z plakietką **Zweryfikowane**.
  </Step>
</Steps>

Jeśli kreator nie znajdzie adresu URL żądania we wklejonych danych, poinformuje o tym —
uwzględnij pełny endpoint `http(s)` i spróbuj ponownie.

## Konfiguracja ręczna

Kliknij **Skonfiguruj ręcznie →** w kreatorze (lub **Chcesz, aby AI to wywnioskowała?
Wypróbuj kreatora →**, aby wrócić). Kreator ręcznej konfiguracji ma dwa edytory:

* **Wizualny** — pola formularza dla nazwy wyświetlanej, nazwy funkcji, żądanego
  **adresu URL**, **metody** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), niestandardowych
  **nagłówków** i schematu parametrów (**Dodaj właściwość** dla każdego
  argumentu, który może podać agent).
* **JSON** — ta sama definicja jako surowy JSON, do wklejenia lub precyzyjnego dostosowania
  specyfikacji narzędzia bezpośrednio.

Panel **Żądanie testowe** (opcjonalny) pozwala wysłać skonfigurowane żądanie
przed zapisaniem oraz pokazuje status, opóźnienie i podgląd odpowiedzi.
**Zweryfikuj i zapisz** zawsze uruchamia ten test i zapisuje tylko po powodzeniu.

<Tip>
  Nadaj parametrom opisy w prostym języku („Adres e-mail klienta,
  np. [jane@example.com](mailto:jane@example.com)”). Agent wybiera argumenty na podstawie tych
  opisów w czasie rzeczywistym, w trakcie rozmowy.
</Tip>

## Zarządzanie połączeniami

Każdy wiersz połączenia pokazuje jego status weryfikacji — **Zweryfikowane**,
**Nieprzetestowane** lub **Błąd** — nazwę funkcji oraz agentów, którzy z niego korzystają.
W menu działań wiersza możesz:

* **Edytuj** — ponownie otworzyć konfigurację.
* **Klonuj** — zduplikować połączenie jako punkt wyjścia (kopia ma status
  Nieprzetestowane).
* **Historia wersji** — wyświetlić wcześniejsze wersje i przywrócić jedną z nich w
  edytorze.
* **Przenieś** — skopiować lub przenieść połączenie do innej organizacji, do której
  należysz. Przeniesienie usuwa je tutaj; agenci, którzy z niego korzystali, mogą wymagać
  ponownej konfiguracji.
* **Usuń** — działanie trwałe; agenci korzystający z połączenia będą wymagać
  ponownej konfiguracji.

## Dołącz do agenta

Dodaj połączenie do agenta w sekcji połączeń API kreatora
([Utwórz agenta](/pl/guides/build-an-agent)). Lista pokazuje, którzy agenci
korzystają z każdego połączenia, dzięki czemu od razu wiesz, czego dotyczy zmiana.

## Kolejne kroki

<CardGroup cols={2}>
  <Card title="Integracje narzędzi przez API" icon="code" href="/pl/guides/build-tool-integration">
    Twórz i zarządzaj tymi samymi połączeniami programowo.
  </Card>

  <Card title="Połącz aplikacje" icon="cable" href="/pl/guides/connect-apps">
    Gotowe połączenia z Google, Slack, HubSpot, Salesforce i Cal.com.
  </Card>

  <Card title="Dodaj serwer MCP" icon="server" href="/pl/guides/mcp-servers">
    Udostępnij swoim agentom cały serwer narzędzi.
  </Card>

  <Card title="Dokumentacja API integracji" icon="book" href="/api-reference/integrations">
    Każde pole zasobu integracji.
  </Card>
</CardGroup>