---
title: "Povezave API"
description: "Pretvorite kateri koli HTTP API v funkcijo, ki jo lahko vaš agent pokliče med pogovorom: prilepite ukaz cURL, čarovnik pa ustvari definicijo orodja, parametre in preverjanje pristnosti."
---

API-povezave so prilagojene funkcije HTTP, ki jih lahko vaši agenti pokličejo med
pogovorom — poiščejo naročilo, ustvarijo zahtevek ali pridobijo stanje računa
iz vaše lastne zaledne storitve. Končno točko enkrat določite v razdelku
**Povezave → API-ji** (`/dashboard/api-connections`); agenti, ki imajo
povezavo dodano, jo lahko nato uporabijo, kadar to zahteva potek pogovora.

Povezavo lahko ustvarite na dva načina: prilepite nekaj, kar lahko čarovnik analizira,
ali pa povezavo nastavite ročno.

## Hitra pot: prilepite in analizirajte

<Steps>
  <Step title="Kliknite Nova API-povezava">
    Pogovorno okno se odpre v čarovniku. V polje prilepite vzorčni **ukaz
    cURL**, **specifikacijo OpenAPI/Swagger**, **izvoz Postman**,
    **vmesnik TypeScript** ali **shemo Zod**.
  </Step>
  <Step title="Kliknite Analizirajte">
    ThunderPhone iz vašega prilepljenega besedila razbere celotno povezavo — URL,
    metodo, glave in shemo parametrov, izpeljano iz parametrov poizvedbe
    in telesa zahteve, ki ju najde. Glave, ki ste jih prilepili (vključno z
    avtentikacijskimi glavami), se prenesejo v konfiguracijo končne točke.
  </Step>
  <Step title="Potrdite označena polja">
    Razbrana konfiguracija se odpre s predvidenimi polji, označenimi
    za pregled. Prilagodite imena, opise in vrste parametrov, da agent razume,
    kdaj in kako naj pokliče funkcijo — opis je tisto, kar bere model.
  </Step>
  <Step title="Preverite in shranite">
    Ob shranjevanju se najprej izvede preizkusna zahteva v živo proti vaši končni točki. Če
    zahteva ne uspe, povezava ni shranjena — popravite URL, avtentikacijske
    glave ali telo in poskusite znova. Ob uspehu se povezava shrani
    z oznako **Validirano**.
  </Step>
</Steps>

Če čarovnik v vašem prilepljenem besedilu ne najde URL-ja zahteve, vas bo o tem obvestil —
vključite celotno končno točko `http(s)` in poskusite znova.

## Ročna nastavitev

V čarovniku kliknite **Nastavite ročno →** (ali **Želite, da to razbere AI?
Preizkusite čarovnika →**, da se vrnete). Ročno orodje ima dva urejevalnika:

- **Vizualno** — polja obrazca za prikazno ime, ime funkcije, zahtevo
  **URL**, **metodo** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), prilagojene
  **glave** in shemo parametrov (**Dodajte lastnost** za vsak
  argument, ki ga lahko posreduje agent).
- **JSON** — enaka definicija kot neobdelan JSON za neposredno lepljenje ali natančno prilagajanje
  specifikacije orodja.

Plošča **Preizkusite zahtevo** (izbirno) omogoča, da konfigurirano zahtevo pošljete
pred shranjevanjem, ter prikaže stanje, zakasnitev in predogled odgovora.
**Preverite in shranite** vedno izvede ta preizkus in shrani le ob uspehu.

<Tip>
  Parametrom dodajte opise v razumljivem jeziku ("E-poštni naslov stranke,
  npr. jane@example.com"). Glasovni agent med klicem v realnem času na podlagi teh
  opisov izbere argumente.
</Tip>

## Upravljajte svoje povezave

Vsaka vrstica povezave prikazuje stanje preverjanja — **Validirano**,
**Nepreverjeno** ali **Napaka** — ime funkcije in agente, ki jo uporabljajo.
V meniju dejanj vrstice lahko:

- **Uredite** — znova odprete konfiguracijo.
- **Klonirajte** — podvojite povezavo kot izhodišče (kopija je sprva
  Nepreverjena).
- **Zgodovina revizij** — ogledate si prejšnje različice in eno obnovite v
  urejevalniku.
- **Prenesite** — kopirate ali premaknete povezavo v drugo organizacijo, ki ji
  pripadate. Premik jo odstrani tukaj; agenti, ki so jo uporabljali, bodo morda potrebovali
  ponovno konfiguracijo.
- **Izbrišite** — trajno brisanje; agente, ki uporabljajo povezavo, bo treba
  znova konfigurirati.

## Dodajte jo agentu

Povezavo dodajte agentu v razdelku API-povezave orodja za izdelavo agenta
([Ustvarite agenta](/sl/guides/build-an-agent)). Seznam prikazuje, kateri agenti
uporabljajo posamezno povezavo, zato lahko takoj vidite, na kaj vpliva sprememba.

## Naslednji koraki

<CardGroup cols={2}>
  <Card title="Integracije orodij prek API-ja" icon="code" href="/sl/guides/build-tool-integration">
    Enake povezave ustvarite in upravljajte programsko.
  </Card>
  <Card title="Povežite aplikacije" icon="cable" href="/sl/guides/connect-apps">
    Vnaprej pripravljene povezave za Google, Slack, HubSpot, Salesforce in Cal.com.
  </Card>
  <Card title="Dodajte strežnik MCP" icon="server" href="/sl/guides/mcp-servers">
    Svojim agentom izpostavite celoten strežnik orodij.
  </Card>
  <Card title="Referenca API-ja za integracije" icon="book" href="/api-reference/integrations">
    Vsako polje v viru integracije.
  </Card>
</CardGroup>