---
title: "API връзки"
description: "Превърнете всеки HTTP API във функция, която вашият агент може да извика по време на разговор: поставете cURL команда, а съветникът ще създаде дефиницията на инструмента, параметрите и удостоверяването."
---

API връзките са персонализирани HTTP функции, които вашите агенти могат да извикват по време на
разговор — да проверяват поръчка, да създават тикет, да извличат статуса на акаунт
от вашия собствен бекенд. Дефинирате крайната точка еднократно в
**Връзки → API** (`/dashboard/api-connections`); агентите, към които е
добавена връзката, могат да я извикват винаги, когато разговорът
го изисква.

Има два начина да създадете такава: да поставите нещо, което съветникът може да анализира,
или да настроите връзката ръчно.

## Бързият начин: поставяне и анализиране

<Steps>
  <Step title="Щракнете върху Нова API връзка">
    Диалоговият прозорец се отваря в съветника. Поставете примерна **cURL команда**,
    **спецификация OpenAPI/Swagger**, **експорт от Postman**, **интерфейс на TypeScript**
    или **Zod схема** в полето.
  </Step>
  <Step title="Щракнете върху Анализиране">
    ThunderPhone извежда цялата връзка от поставеното съдържание — URL адрес,
    метод, заглавки и схема на параметрите, извлечена от параметрите на заявката
    и тялото на заявката, които е открил. Поставените от вас заглавки (включително
    заглавки за удостоверяване) се пренасят в конфигурацията на крайната точка.
  </Step>
  <Step title="Потвърдете маркираните полета">
    Изведената конфигурация се отваря с маркирани предполагаеми полета
    за преглед. Коригирайте имената, описанията и типовете параметри, за да може
    агентът да разбере кога и как да извика функцията — описанието
    е това, което моделът чете.
  </Step>
  <Step title="Потвърждаване и запазване">
    Запазването първо изпълнява тестова заявка в реално време към вашата крайна точка. Ако
    заявката е неуспешна, връзката не се запазва — коригирайте URL адреса, заглавките
    за удостоверяване или тялото и опитайте отново. При успех връзката се съхранява
    със значка **Потвърдена**.
  </Step>
</Steps>

Ако съветникът не може да открие URL адрес на заявка в поставеното съдържание, ще ви уведоми —
включете пълна крайна точка `http(s)` и опитайте отново.

## Ръчна настройка

Щракнете върху **Ръчна настройка →** в съветника (или върху **Искате AI да изведе това?
Опитайте съветника →**, за да се върнете). Ръчният конструктор има два редактора:

- **Визуален** — полета на формуляр за показваното име, името на функцията, заявката
  **URL**, **метода** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), персонализираните
  **заглавки** и схемата на параметрите (**Добавяне на свойство** за всеки
  аргумент, който агентът може да подаде).
- **JSON** — същата дефиниция като суров JSON за поставяне или прецизна настройка
  на спецификация на инструмент директно.

Панелът **Тестова заявка** (незадължителен) ви позволява да изпратите конфигурираната заявка
преди запазване и показва статуса, закъснението и предварителен преглед на отговора.
**Потвърждаване и запазване** винаги изпълнява този тест и запазва само при успех.

<Tip>
  Давайте на параметрите описания на ясен език („Имейл адрес на клиента,
  напр. jane@example.com“). Агентът избира аргументи от тези
  описания в реално време, по време на разговора.
</Tip>

## Управление на вашите връзки

Всеки ред за връзка показва статуса на потвърждаване — **Потвърдена**,
**Нетествана** или **Грешка** — името на функцията и кои агенти я използват.
От менюто с действия на реда можете да:

- **Редактиране** — отворите отново конфигурацията.
- **Клониране** — дублирате я като начална точка (копието започва като
  Нетествано).
- **Хронология на редакциите** — прегледате по-ранни версии и възстановите една в
  редактора.
- **Прехвърляне** — копирате или преместите връзката в друга организация, към която
  принадлежите. Преместването я премахва тук; агентите, които са я използвали, може да се нуждаят
  от преконфигуриране.
- **Изтриване** — окончателно; агентите, които използват връзката, ще трябва да бъдат
  преконфигурирани.

## Добавяне към агент

Добавете връзката към агент в раздела за API връзки на конструктора
([Създаване на агент](/bg/guides/build-an-agent)). Списъкът показва кои агенти
използват всяка връзка, така че с един поглед можете да видите какво засяга дадена промяна.

## Следващи стъпки

<CardGroup cols={2}>
  <Card title="Интеграции с инструменти чрез API" icon="code" href="/bg/guides/build-tool-integration">
    Създавайте и управлявайте същите връзки програмно.
  </Card>
  <Card title="Свързване на приложения" icon="cable" href="/bg/guides/connect-apps">
    Готови връзки с Google, Slack, HubSpot, Salesforce и Cal.com.
  </Card>
  <Card title="Добавяне на MCP сървър" icon="server" href="/bg/guides/mcp-servers">
    Предоставете на агентите си достъп до цял сървър с инструменти.
  </Card>
  <Card title="API справочник за интеграции" icon="book" href="/api-reference/integrations">
    Всяко поле в ресурса за интеграция.
  </Card>
</CardGroup>