Премини към основното съдържание
Български— Изберете език
Меню

Свързване на Вашия GPT с външни API

Урок 9 от 17 Обновен 5 ноември 2026 г. Средно
На тази страница
  1. Излизане извън рамките на изолирания GPT
  2. Какво е действие (Action)?
  3. OpenAPI схемата
  4. Конфигуриране на действие в редактора на GPT
  5. Ваш ред: Публично API
  6. Ключови изводи

Статус към 5 ноември 2026 г.: GPTs са в последните си седмици. OpenAI прекратява поддръжката на персонализирани GPTs на 11 декември 2026 г. (11 февруари 2027 г. за определени работни пространства Enterprise с изключение). Личните акаунти Free, Go, Plus и Pro вече не могат да създават или публикуват нови GPTs; в работните пространства Business, Enterprise и Edu създаването зависи от настройките и бе преустановено на 26 октомври 2026 г. в засегнатите пространства Enterprise. Съществуващите GPTs остават използваеми и редактируеми, ако планът Ви позволява, до момента на прекратяване; разговорите Ви с тях ще останат достъпни и след това. Миграцията (Migrate to plugin, в My GPTs) превръща инструкциите в умение (skill), базата знания в референтни файлове, а свързаните приложения – в приложения; персонализираните действия не се прехвърлят. Този урок обяснява как работят GPTs, за да Ви помогне да ги поддържате, мигрирате и адаптирате техните принципи към плъгин (уроци 15–17).

Излизане извън рамките на изолирания GPT

Досега Вашият GPT работеше в изолация: инструкциите му определят поведението, а базата знания (Knowledge) предоставя Вашите документи. Това е мощно, но остава откъснато от живия свят. Той не може да провери CRM системата Ви в реално време, да създаде събитие в календара или да направи заявка към базата данни – знае само това, което сте качили, замръзнало във времето на качването. Действията (Actions) премахват това ограничение: те позволяват на Вашия GPT да извиква външни API, за да чете и записва данни във Вашите инструменти по време на разговор.

Какво е действие (Action)?

Действието е връзка между Вашия GPT и външна услуга чрез нейното API. Потокът винаги е един и същ: потребителят задава въпрос или дава инструкция, GPT идентифицира, че му трябват външни данни, за да отговори, извиква API на услугата, получава отговора и го интегрира в крайния си отговор. Помислете за търговски GPT, свързан с CRM: когато потребителят попита „Какъв е статусът на досието на Дюпон?“, GPT прави заявка към CRM API, извлича записа за клиента и отговаря с данни към днешна дата – а не със спомен за файл, качен преди три месеца. Всичко това се случва прозрачно за потребителя, който просто има усещането, че разговаря с добре информиран асистент.

OpenAPI схемата

За да може GPT да извика API, трябва да го опишете. Това е ролята на OpenAPI схемата (позната преди като Swagger) – JSON или YAML файл, който служи като ръководство за API. Тя описва крайните точки (endpoints) – URL адресите, които GPT може да извика, – свързаните методи (GET за четене, POST за създаване, PUT за актуализиране, DELETE за изтриване), параметрите, очаквани от всяка крайна точка, и формата на върнатите отговори. Въз основа на този документ GPT самостоятелно решава по време на разговора коя крайна точка да извика и с какви параметри.

Ето как изглежда минимална схема за фиктивно API за времето:

openapi: 3.1.0
info:
  title: Weather API
  version: 1.0.0
servers:
  - url: https://example.com
paths:
  /forecast:
    get:
      operationId: getForecast
      summary: Get weather forecast for a city
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Weather forecast

Добрата новина е, че почти никога няма да се наложи да пишете този файл от нулата. Много услуги публикуват своята OpenAPI схема директно в документацията на своето API. Ако не е така, инструменти като Swagger Editor – или самият ChatGPT, ако му опишете API – могат да я генерират. А ако Вашият технически екип работи с Postman, неговите колекции се експортират във формат OpenAPI.

Конфигуриране на действие в редактора на GPT

Настройката се извършва в уеб редактора на Вашия GPT: отидете в секцията Actions, кликнете върху Create new action, поставете Вашата OpenAPI схема в предоставеното поле, конфигурирайте удостоверяването (разгледано в следващия урок) и тествайте действието от панела за предварителен преглед.

Качеството на Вашата схема определя качеството на извикванията. Спазвайте три основни правила. Първо, дайте ясни имена на стойностите operationId: GPT разчита на тях, за да реши кое действие да извика, и getForecast го насочва много по-добре от op_42. След това напишете ясни описания за всяка крайна точка и параметър – на естествен език, сякаш обяснявате API на колега. Накрая, изложете само крайните точки, които действително Ви трябват: ако Вашият GPT се нуждае само от две или три маршрута, не излагайте всичките четиридесет маршрута на пълното API. Всяка изложена крайна точка заема място в контекста на GPT и увеличава риска той да избере грешната.

Действие в четири стъпки Четири стъпки: опишете API с OpenAPI схема в JSON или YAML; изберете удостоверяване – никакво, ключ или OAuth; тествайте в предварителен преглед; след това GPT извиква API, когато е полезно. СВЪРЖЕТЕ API Действие в четири стъпки 1 Схема OpenAPI, JSON или YAML 2 Достъп Няма, ключ или OAuth 3 Тест В предварителен преглед 4 Използване GPT извиква API Няма действия в режим Pro и действията не се прехвърлят към плъгин.
Въз основа на статията „Configuring actions in GPTs“ от OpenAI Help Center (ноември 2026 г.).

Ваш ред: Публично API

Вашето първо действие или неговият план. Най-доброто място за обучение е безплатно, публично API – за време, валутни курсове, новини – което не изисква сложно удостоверяване. Изберете едно, извлечете или създайте неговата OpenAPI схема и го добавете като действие във Вашия GPT. Не забравяйте да свържете действието с Вашите инструкции, като уточните кога да се използва: „Когато потребителят попита за времето, използвай действието getForecast.“ След това тествайте с няколко различни формулировки, за да проверите дали GPT задейства извикването в правилния момент.

Няколко капана очакват първите опити. Неправилно форматирана схема – една липсваща запетая в JSON – блокира всичко: винаги валидирайте схемата си в Swagger Editor, преди да я поставите. Липсващите описания оставят GPT сляп: без тях той не знае кога едно действие е уместно. Също така предвидете грешки в API, които рано или късно ще се случат: уточнете поведението в инструкциите си, например: „Ако API не отговори, кажете на потребителя да опита отново по-късно“ – в противен случай GPT ще импровизира, понякога измисляйки данни. И не разчитайте единствено на панела за предварителен преглед: тествайте в реални условия, с реални данни и реални формулировки от потребители.

Преди да започнете, знайте две ограничения: един GPT използва или свързани приложения, или действия, но не и двете едновременно, а действията не работят в режим Pro. Най-важното е, че персонализираните действия не се прехвърлят към плъгин по време на миграция: първо проверете дали директорията с плъгини вече предлага приложение за целевата Ви услуга; ако не, ще трябва да възстановите интеграцията, например със сървър MCP.

Официални източници: Configuring actions in GPTs (OpenAI Help Center: удостоверяване, OpenAPI схема, тестване, ограничения) · Custom GPT retirement and migration FAQ (действията не се прехвърлят) · OpenAPI Specification (формат на схемата)

Ключови изводи

  • Действията свързват Вашия GPT с външни услуги чрез техните API
  • Трябва да предоставите OpenAPI схема, описваща наличните крайни точки
  • Описанията в схемата са от съществено значение – GPT ги използва, за да реши кое действие да извика
  • Започнете с безплатно публично API, за да се запознаете с процеса
  • Ограничете изложените крайни точки до строгия минимум за Вашия случай на употреба