---
title: "API veze"
description: "Pretvorite bilo koji HTTP API u funkciju koju vaš agent može pozvati usred razgovora: zalijepite cURL naredbu, a čarobnjak će izraditi definiciju alata, parametre i autentifikaciju."
---

API veze prilagođene su HTTP funkcije koje vaši agenti mogu pozvati tijekom
razgovora — pronaći narudžbu, izraditi tiket, dohvatiti status računa
iz vlastitog pozadinskog sustava. Krajnju točku definirate jednom u odjeljku
**Veze → API-ji** (`/dashboard/api-connections`); agenti kojima je
veza priložena zatim je mogu pozvati kad god to razgovor zahtijeva.

Postoje dva načina za izradu: zalijepite sadržaj koji čarobnjak može analizirati
ili ručno postavite vezu.

## Brzi način: zalijepite i analizirajte

<Steps>
  <Step title="Kliknite Nova API veza">
    Dijaloški okvir otvara se u čarobnjaku. U okvir zalijepite primjer
    **cURL naredbe**, **OpenAPI/Swagger specifikacije**, **Postman
    izvoza**, **TypeScript sučelja** ili **Zod sheme**.
  </Step>
  <Step title="Kliknite Analizirajte">
    ThunderPhone iz vašeg zalijepljenog sadržaja zaključuje cijelu vezu — URL,
    metodu, zaglavlja i shemu parametara izvedenu iz parametara upita
    i tijela zahtjeva koje je pronašao. Zaglavlja koja ste zalijepili (uključujući
    zaglavlja za autentifikaciju) prenose se u konfiguraciju krajnje točke.
  </Step>
  <Step title="Potvrdite istaknuta polja">
    Zaključena konfiguracija otvara se s istaknutim pretpostavljenim poljima
    radi pregleda. Prilagodite nazive, opise i vrste parametara kako bi
    agent razumio kada i kako pozvati funkciju — opis je ono što model čita.
  </Step>
  <Step title="Provjerite i spremite">
    Spremanje najprije pokreće stvarni testni zahtjev prema vašoj krajnjoj točki.
    Ako zahtjev ne uspije, veza se ne sprema — ispravite URL, zaglavlja za
    autentifikaciju ili tijelo i pokušajte ponovno. Nakon uspjeha veza se sprema
    s oznakom **Potvrđeno**.
  </Step>
</Steps>

Ako čarobnjak u zalijepljenom sadržaju ne može pronaći URL zahtjeva, obavijestit će vas
o tome — uključite potpunu `http(s)` krajnju točku i pokušajte ponovno.

## Ručno postavljanje

U čarobnjaku kliknite **Postavite ručno →** (ili **Želite da AI to zaključi?
Isprobajte čarobnjak →** za povratak). Ručni alat za izradu ima dva uređivača:

- **Vizualno** — polja obrasca za prikazni naziv, naziv funkcije, zahtjev
  **URL**, **metodu** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), prilagođena
  **zaglavlja** i shemu parametara (**Dodajte svojstvo** za svaki
  argument koji agent može navesti).
- **JSON** — ista definicija kao neobrađeni JSON, za izravno lijepljenje
  ili fino podešavanje specifikacije alata.

Ploča **Testni zahtjev** (nije obavezna) omogućuje slanje konfiguriranog zahtjeva
prije spremanja te prikazuje status, kašnjenje i pretpregled odgovora.
**Provjerite i spremite** uvijek pokreće ovaj test i sprema samo nakon uspjeha.

<Tip>
  Parametrima dodijelite opise jednostavnim jezikom ("Adresa e-pošte korisnika,
  npr. jane@example.com"). Agent u stvarnom vremenu, usred poziva, odabire
  argumente na temelju tih opisa.
</Tip>

## Upravljajte svojim vezama

Svaki red veze prikazuje status provjere — **Potvrđeno**,
**Nije testirano** ili **Pogreška** — naziv funkcije i agente koji je koriste.
Iz izbornika radnji retka možete:

- **Urediti** — ponovno otvoriti konfiguraciju.
- **Klonirati** — duplicirati je kao početnu točku (kopija počinje sa statusom
  Nije testirano).
- **Povijest revizija** — pregledati ranije verzije i vratiti jednu u
  uređivač.
- **Prenijeti** — kopirati ili premjestiti vezu u drugu organizaciju kojoj
  pripadate. Premještanje je ovdje uklanja; agenti koji su je koristili možda će
  trebati ponovnu konfiguraciju.
- **Izbrisati** — trajno; agente koji koriste vezu bit će potrebno
  ponovno konfigurirati.

## Priložite je agentu

Dodajte vezu agentu u odjeljku API veze alata za izradu
([Izradite agenta](/hr/guides/build-an-agent)). Popis prikazuje koji agenti
koriste svaku vezu, tako da na prvi pogled možete vidjeti na što promjena utječe.

## Sljedeći koraci

<CardGroup cols={2}>
  <Card title="Integracije alata putem API-ja" icon="code" href="/hr/guides/build-tool-integration">
    Programsko stvaranje i upravljanje istim vezama.
  </Card>
  <Card title="Povežite aplikacije" icon="cable" href="/hr/guides/connect-apps">
    Unaprijed izrađene veze za Google, Slack, HubSpot, Salesforce i Cal.com.
  </Card>
  <Card title="Dodajte MCP poslužitelj" icon="server" href="/hr/guides/mcp-servers">
    Omogućite svojim agentima pristup cijelom poslužitelju alata.
  </Card>
  <Card title="Referenca API-ja za integracije" icon="book" href="/api-reference/integrations">
    Svako polje na resursu integracije.
  </Card>
</CardGroup>