Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Arhitektūra: rīki, resursi un saskarne

Nodarbība 2 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Pārskats
  2. Ko MCP serveris eksponē
  3. Pieprasījuma plūsma
  4. Transports un autorizācija
  5. Saskarne: neobligāts slānis
  6. Prasmes: darbplūsmas slānis
  7. Kā ar tirdzniecību?
  8. Galvenās atziņas

Nodarbība pārrakstīta 2026. gada 3. novembrī, balstoties uz MCP servera, Spraudņu arhitektūras un Prasmju lapām OpenAI spraudņu dokumentācijā. Vecā „darbību, logrīku, tirdzniecības” arhitektūra aprakstīja SDK, kas vairs nepastāv. Avoti: MCP serveris · Spraudņu arhitektūra · Prasmes.

Pārskats

Spraudnis sastāv no neatkarīgiem slāņiem. Prasmes nodrošina darbības plānu, MCP serveris nodrošina iespējas, bet saskarne vajadzības gadījumā piedāvā vizuālu mijiedarbības veidu.

Spraudnis
├── Prasmes
└── MCP serveris (neobligāts)
    ├── Rīki un strukturēti rezultāti
    └── Saskarnes resursi (neobligāti)

Katram slānim ir sava loma. Dokumentācija šo robežu apkopo šādi: MCP serveris nodrošina datus, autentifikāciju, autorizāciju un darbības; prasme nodrošina atkārtoti izmantojamas instrukcijas, piemērus un dokumentu veidnes.

Ko MCP serveris eksponē

MCP serveris var eksponēt četru veidu vienības:

  • Rīki: Funkcijas, ko modelis izsauc ar strukturētām ievadēm.
  • Resursi: Dati vai saturs, ko klients var nolasīt.
  • Uzvednes: Atkārtoti izmantojamas uzvedņu veidnes.
  • Instrukcijas: Norādījumi, kas attiecas uz visu serveri.

Spraudņi galvenokārt paļaujas uz rīkiem. Katram rīkam ir nosaukums, apraksts, ievades shēma un, neobligāti, izvades shēma. Šie lauki ļauj modelim lemt, kad izsaukt rīku un kā izmantot tā rezultātu.

Pieprasījuma plūsma

Kad lietotājs veic pieprasījumu, kas atbilst kādam rīkam, secīgi notiek četras darbības:

  1. Klients atklāj MCP servera eksponētos rīkus.
  2. Modelis izvēlas rīku un norāda argumentus, kas atbilst tā ievades shēmai.
  3. Serveris validē pieprasījumu, veic darbību un atgriež rezultātu.
  4. Modelis izmanto šo rezultātu, lai turpinātu sarunu.

Rīka rezultāts var saturēt trīs daļas. structuredContent satur kodolīgus datus, kurus modelis var pārbaudīt un atkārtoti izmantot turpmākajos izsaukumos. content satur tekstu vai citu MCP saturu, kas palīdz modelim formulēt atbildi. _meta satur datus, kas paredzēti klientam un ir slēpti no modeļa — slēpti, bet neaizsargāti. Šis lauks neaizstāj autorizāciju vai drošu glabāšanu.

Transports un autorizācija

Produkcijas vidē izvieto MCP serveri stabilā HTTPS adresē, izmantojot protokola streamable HTTP transportu, parasti ceļā /mcp. Ja rīki lasa privātus datus vai darbojas lietotāja vārdā, aizsargā serveri ar MCP specifikācijā definēto autorizācijas plūsmu — OAuth, ko sīkāk aplūko 8. nodarbībā.

Saskarne: neobligāts slānis

Rīkam ir jādarbojas bez saskarnes: kodolīgs teksts un strukturēts rezultāts bieži vien ir pietiekami, lai modelis sniegtu atbildi. Saskarne ir jēdzīga tad, ja lietotājam ir jāpārbauda, jāsalīdzina, jāmaina, jāapstiprina vai jāpārlūko strukturēta informācija — piemēram, produktu salīdzinājums, rediģējams grafiks vai karte. Vienkārša statusa pārbaude parasti to neprasa.

Ja saskarne ir pieejama, tā ir resurss, ko serveris deklarē. ChatGPT to attēlo iframe, kad saistītais rīks to atgriež. ChatGPT ievieš atvērto MCP Apps standartu: saskarne sazinās ar resursdatoru, izmantojot JSON-RPC, caur postMessage. ChatGPT specifiskie paplašinājumi, kas pieejami caur window.openai, papildina standartu gadījumos, kad tas neaptver konkrētu vajadzību. To aplūko 6. nodarbībā.

Prasmes: darbplūsmas slānis

Prasme ir mape, kas satur failu SKILL.md — nosaukumu, aprakstu, kas informē modeli, kad to ņemt vērā, instrukcijas un, ja nepieciešams, atsauces, skriptus vai veidnes. Modelis sākotnēji redz tikai nosaukumu un aprakstu; tas ielādē pilnas instrukcijas, kad pieprasījums atbilst prasmei vai kad lietotājs to izsauc tieši. Tādēļ OpenAI iesaka: raksti aprakstu, balstoties uz lietotāja mērķi un aktivizēšanas nosacījumiem, bet soli pa solim detaļas atstāj pamattekstā.

Kā ar tirdzniecību?

Pārdošana, izmantojot spraudni, nav atsevišķs slānis. Tas ir ceļojums, ko var atbalstīt neobligātā saskarne, izmantojot OpenAI dokumentēto Checkout API. 7. nodarbībā skaidrots, kā tas darbojas un kādi ir tā ierobežojumi.

Galvenās atziņas

  • MCP serveris eksponē rīkus, resursus, uzvednes un instrukcijas; spraudņi galvenokārt paļaujas uz rīkiem
  • Rīka rezultāts apvieno structuredContent, content un _meta (slēpts no modeļa, bet nedrošs)
  • Produkcija: stabils HTTPS, streamable HTTP transports, autorizācija saskaņā ar MCP specifikāciju
  • Saskarne ir neobligāts resurss, ko ChatGPT attēlo saskaņā ar MCP Apps standartu
  • Prasmes pārvalda darbplūsmu; serveris pārvalda datus, autorizāciju un darbības