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

Архитектура: Инструменти, ресурси и интерфейс

Урок 2 от 14 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Преглед
  2. Какво излага един MCP сървър
  3. Потокът на заявката
  4. Транспорт и оторизация
  5. Интерфейсът: Опционален слой
  6. Умения: Слой на работния поток
  7. А какво да кажем за търговията?
  8. Ключови изводи

Урокът е пренаписан на 3 ноември 2026 г. въз основа на страниците за MCP сървър, Архитектура на плъгините и Умения (Skills) в документацията на OpenAI за плъгини. Описаната в миналото архитектура „действия, уиджети, търговия“ се отнасяше за SDK, което вече не съществува. Източници: MCP server · Plugin architecture · Skills.

Преглед

Един плъгин се състои от независими слоеве. Уменията (Skills) осигуряват плана за действие, MCP сървърът предоставя възможностите, а интерфейсът предлага визуален начин за взаимодействие, когато е необходимо.

Plugin
├── Skills
└── MCP Server (optional)
    ├── Tools and structured results
    └── Interface resources (optional)

Всеки слой има различна роля. Документацията обобщава границата по следния начин: MCP сървърът предоставя данни, удостоверяване, оторизация и действия; умението предоставя многократни инструкции, примери и шаблони за документи.

Какво излага един MCP сървър

Един MCP сървър може да изложи четири типа обекти:

  • Инструменти (Tools): Функции, които моделът извиква със структурирани входни данни.
  • Ресурси: Данни или съдържание, които клиентът може да прочете.
  • Подкани (Prompts): Многократни шаблони за подкани.
  • Инструкции: Директиви, които се прилагат за целия сървър.

Плъгините разчитат предимно на инструменти. Всеки инструмент има име, описание, схема за входни данни и по желание – схема за изходни данни. Тези полета позволяват на модела да реши кога да извика инструмента и как да използва резултата от него.

Потокът на заявката

Когато потребителят направи заявка, която съвпада с даден инструмент, се изпълняват последователно четири стъпки:

  1. Клиентът открива инструментите, изложени от MCP сървъра.
  2. Моделът избира инструмент и предоставя аргументи, които отговарят на неговата схема за входни данни.
  3. Сървърът валидира заявката, изпълнява операцията и връща резултат.
  4. Моделът използва този резултат, за да продължи разговора.

Резултатът от инструмента може да съдържа три части. structuredContent носи сбити данни, които моделът може да инспектира и използва повторно в следващи извиквания. content носи текст или друго MCP съдържание, което помага на модела да формулира отговор. _meta носи данни, предназначени за клиента и скрити от модела – скрити, но не защитени. Това поле не замества оторизацията или сигурното съхранение.

Транспорт и оторизация

В производствена среда разполагайте MCP сървър на стабилен HTTPS адрес, използвайки транспорта streamable HTTP на протокола, обикновено на път /mcp. Ако инструментите четат частни данни или действат от името на потребител, защитете сървъра с потока за оторизация, дефиниран от спецификацията на MCP – OAuth, който е подробно описан в Урок 8.

Интерфейсът: Опционален слой

Един инструмент трябва да работи без интерфейс: сбитият текст и структурираният резултат често са достатъчни, за да може моделът да отговори. Интерфейсът има смисъл, когато потребителят трябва да инспектира, сравнява, модифицира, потвърждава или разглежда структурирана информация – сравнение на продукти, редактируем график или карта. Обикновена проверка на статуса geralmente не се нуждае от такъв.

Когато присъства, интерфейсът е ресурс, който сървърът декларира. ChatGPT го показва в iframe, когато свързаният инструмент го върне. ChatGPT прилага открития стандарт MCP Apps: интерфейсът комуникира с хоста чрез JSON-RPC, използвайки postMessage. Разширенията, специфични за ChatGPT, достъпни чрез window.openai, допълват стандарта, когато той не покрива конкретна нужда. Урок 6 разглежда това.

Умения: Слой на работния поток

Умението е папка, съдържаща файл SKILL.md – име, описание, което казва на модела кога да го вземе предвид, инструкции – и при необходимост – препратки, скриптове или шаблони. Моделът първоначално вижда само името и описанието; той зарежда пълните инструкции, когато заявката съвпада с умението или когато потребителят го извика директно. Затова съветът на OpenAI е: напишете описанието около целта на потребителя и условията за задействане, а подробностите стъпка по стъпка оставете в тялото на файла.

А какво да кажем за търговията?

Продажбата чрез плъгин не е отделен слой. Това е пътешествие, което опционалният интерфейс може да подкрепи, използвайки Checkout API, документиран от OpenAI. Урок 7 обяснява как работи това и какви са ограниченията му.

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

  • MCP сървърът излага инструменти, ресурси, подкани и инструкции; плъгините разчитат предимно на инструменти
  • Резултатът от инструмента комбинира structuredContent, content и _meta (скрито от модела, но не сигурно)
  • Производство: стабилен HTTPS, транспорт streamable HTTP, оторизация според спецификацията на MCP
  • Интерфейсът е опционален ресурс, показван от ChatGPT според стандарта MCP Apps
  • Уменията управляват работния поток; сървърът управлява данните, оторизацията и действията