---
title: "API savienojumi"
description: "Pārvērtiet jebkuru HTTP API par funkciju, ko jūsu balss aģents var izsaukt sarunas laikā: ielīmējiet cURL komandu, un vednis izveidos rīka definīciju, parametrus un autentifikāciju."
---

API savienojumi ir pielāgotas HTTP funkcijas, ko jūsu aģenti var izsaukt
sarunas laikā — lai atrastu pasūtījumu, izveidotu biļeti vai iegūtu konta
statusu no jūsu aizmugursistēmas. Galapunktu definējat vienreiz sadaļā
**Savienojumi → API** (`/dashboard/api-connections`); aģenti, kuriem ir
pievienots savienojums, pēc tam var to izsaukt, kad tas ir nepieciešams
sarunā.

To var izveidot divos veidos: ielīmēt kaut ko, ko vednis var analizēt,
vai iestatīt savienojumu manuāli.

## Ātrākais veids: ielīmējiet un analizējiet

<Steps>
  <Step title="Noklikšķiniet uz Jauns API savienojums">
    Dialoglodziņš tiek atvērts vednī. Lodziņā ielīmējiet **cURL komandas**,
    **OpenAPI/Swagger specifikācijas**, **Postman eksporta**, **TypeScript
    saskarnes** vai **Zod shēmas** paraugu.
  </Step>
  <Step title="Noklikšķiniet uz Analizēt">
    ThunderPhone no jūsu ielīmētā satura nosaka visu savienojumu — URL,
    metodi, galvenes un parametru shēmu, kas atvasināta no atrastajiem
    vaicājuma parametriem un pieprasījuma pamatteksta. Ielīmētās galvenes
    (tostarp autentifikācijas galvenes) tiek iekļautas galapunkta konfigurācijā.
  </Step>
  <Step title="Apstipriniet izceltos laukus">
    Noteiktā konfigurācija tiek atvērta ar pārskatīšanai izceltiem
    paredzētajiem laukiem. Pielāgojiet nosaukumus, aprakstus un parametru
    tipus, lai balss aģents saprastu, kad un kā izsaukt funkciju — aprakstu
    lasa modelis.
  </Step>
  <Step title="Validēt un saglabāt">
    Saglabāšanas laikā vispirms tiek palaists reāls testa pieprasījums uz
    jūsu galapunktu. Ja pieprasījums neizdodas, savienojums netiek saglabāts —
    izlabojiet URL, autentifikācijas galvenes vai pamattekstu un mēģiniet vēlreiz.
    Veiksmīgas izpildes gadījumā savienojums tiek saglabāts ar emblēmu
    **Validēts**.
  </Step>
</Steps>

Ja vednis jūsu ielīmētajā saturā nevar atrast pieprasījuma URL, tas to paziņos —
iekļaujiet pilnu `http(s)` galapunktu un mēģiniet vēlreiz.

## Manuāla iestatīšana

Vednī noklikšķiniet uz **Iestatīt manuāli →** (vai uz **Vai vēlaties, lai AI to
nosaka? Izmēģiniet vedni →**, lai atgrieztos). Manuālajā veidotājā ir divi redaktori:

- **Vizuālais** — veidlapas lauki parādāmajam nosaukumam, funkcijas nosaukumam,
  pieprasījuma **URL**, **metodei** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`),
  pielāgotām **galvenēm** un parametru shēmai (**Pievienot rekvizītu** katram
  argumentam, ko balss aģents var norādīt).
- **JSON** — tā pati definīcija neapstrādātā JSON formātā, lai tieši ielīmētu
  vai precizētu rīka specifikāciju.

Panelis **Testēt pieprasījumu** (neobligāts) ļauj pirms saglabāšanas nosūtīt
konfigurēto pieprasījumu un parāda statusu, aizkavi un atbildes priekšskatījumu.
**Validēt un saglabāt** vienmēr izpilda šo testu un saglabā tikai veiksmīgas
izpildes gadījumā.

Galveņu vērtības ir tikai rakstāmas. Pēc saglabāšanas tās tiek šifrētas un vairs nekad netiek rādītas ne informācijas panelī, ne API. Rediģējot savienojumu, saglabātai galvenei tiek rādīts tās nosaukums ar punktiem vērtības vietā un piezīme **Saglabāts**:
atstājiet to nemainītu, lai paturētu saglabāto vērtību, vai ievadiet jaunu vērtību, lai to aizstātu. Testa
pieprasījumos un reālos zvanos tiek izmantota saglabātā vērtība. **Klonēt** kopē saglabātās vērtības
uz jauno savienojumu.

<Tip>
  Norādiet parametriem vienkāršus aprakstus ("Klienta e-pasta adrese,
  piemēram, jane@example.com"). Balss aģents zvana laikā reāllaikā izvēlas
  argumentus, pamatojoties uz šiem aprakstiem.
</Tip>

## Pārvaldiet savus savienojumus

Katrā savienojuma rindā ir redzams validācijas statuss — **Validēts**,
**Netestēts** vai **Kļūda** — funkcijas nosaukums un aģenti, kas to izmanto.
Rindas darbību izvēlnē varat:

- **Rediģēt** — atkārtoti atvērt konfigurāciju.
- **Klonēt** — dublēt to kā sākumpunktu (kopija sākotnēji ir Netestēta).
- **Versiju vēsture** — skatīt iepriekšējās versijas un atjaunot kādu no tām
  redaktorā.
- **Pārsūtīt** — kopēt vai pārvietot savienojumu uz citu organizāciju, kurai
  piederat. Pārvietojot tas tiek noņemts no šejienes; aģentiem, kas to izmantoja,
  var būt nepieciešama pārkonfigurēšana.
- **Dzēst** — neatgriezeniski; aģenti, kas izmanto savienojumu, būs
  jāpārkonfigurē.

## Pievienojiet to aģentam

Pievienojiet savienojumu aģentam veidotāja sadaļā API savienojumi
([Izveidot aģentu](/lv/guides/build-an-agent)). Sarakstā ir redzams, kuri aģenti
izmanto katru savienojumu, tāpēc uzreiz varat redzēt, ko ietekmē izmaiņas.

## Nākamās darbības

<CardGroup cols={2}>
  <Card title="Rīku integrācijas, izmantojot API" icon="code" href="/lv/guides/build-tool-integration">
    Izveidojiet un pārvaldiet tos pašus savienojumus programmatiski.
  </Card>
  <Card title="Pievienojiet lietotnes" icon="cable" href="/lv/guides/connect-apps">
    Iepriekš izveidoti Google, Slack, HubSpot, Salesforce un Cal.com savienojumi.
  </Card>
  <Card title="Pievienojiet MCP serveri" icon="server" href="/lv/guides/mcp-servers">
    Padariet veselu rīku serveri pieejamu saviem balss aģentiem.
  </Card>
  <Card title="Integrāciju API atsauce" icon="book" href="/api-reference/integrations">
    Visi integrācijas resursa lauki.
  </Card>
</CardGroup>