Propojte svůj GPT s externími API
Na této stránce
Stav k 5. listopadu 2026: GPTs končí. OpenAI ukončuje podporu vlastních GPTs 11. prosince 2026 (pro některá pracoviště Enterprise s výjimkou až 11. února 2027). Účty Personal, Free, Go, Plus a Pro již nemohou vytvářet ani publikovat nové GPTs; v pracovištích Business, Enterprise a Edu závisí tvorba na nastavení a v dotčených pracovištích Enterprise skončila 26. října 2026. Stávající GPTs zůstávají použitelné a editovatelné, pokud to váš plán umožňuje, až do ukončení služby; vaše konverzace s nimi zůstanou přístupné i poté. Migrace (Migrate to plugin v sekci My GPTs) převede instrukce na dovednost (skill), znalostní bázi na referenční soubory a připojené aplikace na aplikace; vlastní akce se nepřenesou. Tato lekce vysvětluje, jak GPTs fungují, abyste je mohli udržovat, migrovat a adaptovat jejich principy pro plugin (lekce 15–17).
Překročení hranic samostatného GPT
Dosud váš GPT fungoval v izolaci: jeho instrukce definovaly chování a znalostní báze (Knowledge) poskytovala vaše dokumenty. Je to mocné, ale stále je odříznut od živého světa. Nedokáže v reálném čase zkontrolovat váš CRM, vytvořit událost v kalendáři ani dotazovat vaši databázi – ví jen to, co jste nahráli, a to ve stavu v době nahrání. Akce tento limit odstraňují: umožňují vašemu GPT volat externí API, aby během konverzace četl a zapisoval data ve vašich nástrojích.
Co je to akce?
Akce je propojení mezi vaším GPT a externí službou prostřednictvím jejího API. Tok je vždy stejný: uživatel položí otázku nebo zadá příkaz, GPT zjistí, že k odpovědi potřebuje externí data, zavolá API služby, obdrží odpověď a začlení ji do své finální reakce. Představte si prodejního GPT připojeného k CRM: když se uživatel zeptá „Jaký je stav spisu Dupont?“, GPT se dotáže API CRM, získá záznam klienta a odpoví s dnešními daty – nikoliv s vzpomínkou na soubor nahraný před třemi měsíci. Vše probíhá pro uživatele transparentně, který má pouze pocit, že mluví s dobře informovaným asistentem.
Schéma OpenAPI
Aby GPT mohl volat API, musíte jej popsat. To je úlohou schématu OpenAPI (dříve Swagger), což je soubor JSON nebo YAML sloužící jako návod k obsluze API. Popisuje endpointy – URL adresy, které může GPT volat – přidružené metody (GET pro čtení, POST pro vytvoření, PUT pro aktualizaci, DELETE pro smazání), parametry očekávané každým endpointem a formát vracených odpovědí. Na základě tohoto dokumentu se GPT sám během konverzace rozhodne, který endpoint zavolat a s jakými parametry.
Zde je ukázka minimálního schématu pro fiktivní počasí 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
Dobrá zpráva: tento soubor téměř nikdy nemusíte psát od nuly. Mnoho služeb publikuje své schéma OpenAPI přímo ve své dokumentaci API. Pokud ne, nástroje jako Swagger Editor – nebo samotný ChatGPT, pokud mu API popíšete – jej dokážou vygenerovat. A pokud váš technický tým pracuje s Postmanem, jeho kolekce lze exportovat do formátu OpenAPI.
Konfigurace akce v editoru GPT
Nastavení probíhá ve webovém editoru vašeho GPT: přejděte do sekce Actions, klikněte na Create new action, vložte své schéma OpenAPI do určeného pole, nakonfigurujte ověření (pokryto v další lekci) a poté akci otestujte z náhledového panelu.
Kvalita vašeho schématu určuje kvalitu volání. Mějte na paměti tři zásady. Za prvé, pojmenovávejte hodnoty operationId explicitně: GPT se na ně spoléhá při rozhodování, kterou akci zavolat, a getForecast ho navede mnohem lépe než op_42. Za druhé, pište jasné popisy pro každý endpoint a parametr – přirozeným jazykem, jako byste API vysvětlovali kolegovi. Nakonec vystavte pouze endpointy, které skutečně potřebujete: pokud váš GPT potřebuje jen dvě nebo tři trasy, nevystavujte všech čtyřicet tras celého API. Každý vystavený endpoint zabírá místo v kontextu GPT a zvyšuje riziko, že si vybere ten špatný.
Vaše řada: Veřejné API
Vaše první akce, nebo její plán. Nejlepším cvičištěm je bezplatné, veřejné API – počasí, směnné kurzy, zprávy – které nevyžaduje složité ověření. Vyberte si jedno, získejte nebo vytvořte jeho schéma OpenAPI a přidejte jej jako akci do svého GPT. Nezapomeňte akci propojit se svými instrukcemi specifikací, kdy ji použít: „Když se uživatel zeptá na počasí, použij akci getForecast.“ Poté testujte s několika různými formulacemi, abyste ověřili, že GPT spustí volání ve správný okamžik.
Na první pokusy čeká několik úskalí. Chybně formátované schéma – jediná chybějící čárka v JSON – vše zablokuje: vždy své schéma před vložením validujte v editoru Swagger Editor. Chybějící popisy nechávají GPT slepým: bez nich neví, kdy je akce relevantní. Plánujte také chyby API, které dříve či později nastanou: specifikujte chování ve svých instrukcích, například „Pokud API neodpoví, řekni uživateli, ať to zkusí později“ – jinak bude GPT improvizovat, někdy až vymýšlením dat. A nespoléhejte se pouze na náhledový panel: testujte v reálných podmínkách, s reálnými daty a reálnými formulacemi uživatelů.
Než začnete, mějte na paměti dva limity: GPT využívá buď připojené aplikace, nebo akce, ne obojí, a akce nefungují v režimu Pro. Co je nejdůležitější, vlastní akce se při migraci na plugin nepřenesou: nejprve zkontrolujte, zda adresář pluginů již nabízí aplikaci pro vaši cílovou službu; pokud ne, budete muset integraci znovu vybudovat, například pomocí serveru MCP.
Oficiální zdroje: Configuring actions in GPTs (Centrum nápovědy OpenAI: ověření, schéma OpenAPI, testování, limity) · Custom GPT retirement and migration FAQ (akce se nepřenášejí) · OpenAPI Specification (formát schématu)
Klíčové poznatky
- Akce propojují váš GPT s externími službami prostřednictvím jejich API
- Musíte poskytnout schéma OpenAPI popisující dostupné endpointy
- Popisy ve schématu jsou zásadní – GPT je používá k rozhodování, kterou akci zavolat
- Začněte s bezplatným veřejným API, abyste se seznámili s procesem
- Omezte vystavené endpointy na striktní minimum potřebné pro váš případ použití