Connect Codex

Používejte Codex ve svém terminálu nebo v desktopové aplikaci ChatGPT s modely, MCP nástroji a dovednostmi přes Unity Gateway. Použijte Unity Gateway CLI (ug) pro konfiguraci přístupu nebo ruční konfiguraci připojení.

Než začnete

Potřebujete URL pracovního prostoru Azure Databricks a přístup k modelům, MCP službám a dovednostem, které chcete používat. Nainstalujte si nejnovější verzi Codexu nebo desktopovou aplikaci ChatGPT.

Pokud už váš administrátor vaše zařízení nakonfiguroval, postupujte podle pokynů pro spuštění organizace.

Kodex v terminálu

Instalujte , poté spusťte ugtento příkaz z adresáře vašeho projektu:

ug codex

Postupujte podle pokynů k výběru pracovního prostoru a přihlášení. ug konfiguruje spojení a otevírá Codex ve vašem terminálu. Začněte pracovat se stejnými prompty a příkazy, které už používáte. Pro změnu modelu zadejte /model.

Chcete-li přidat nástroje nebo dovednosti MCP, spusťte tyto příkazy ve svém terminálu a poté restartujte Codex:

ug mcp add
ug skills add

Každý příkaz vám umožní vybrat, co chcete přidat. Pro ruční nastavení použijte níže uvedené konfigurační sekce.

ChatGPT pro počítač

Na macOS a Linuxu nainstalujte ug a spusť tento příkaz v interaktivním terminálu:

ug configure --agents codex

Vyberte si pracovní prostor a přihlaste se. Pokud budete vyzváni, potvrďte aktualizaci konfigurace systému heslem zařízení. ug konfiguruje spojení s Unity Gateway a obnovu tokenu OAuth.

Otevřete nebo restartujte desktopovou aplikaci a začněte konverzaci v Kodexu. Použijte model picker ke změně modelů. Příkaz ug codex otevře terminálového agenta; po konfiguraci normálně otevřete desktopovou aplikaci.

Na Windows použijte níže uvedenou manuální konfiguraci modelu. Stále můžete použít ug mcp add a ug skills add přidat nástroje a dovednosti a pak aplikaci restartovat.

Modely konfigurujte ručně

Tato nastavení platí jak pro terminálového agenta, tak pro desktopovou aplikaci. Zavřete Codex, poté otevřete nebo vytvořte ~/.codex/config.toml. Ve Windows použijte %USERPROFILE%\.codex\config.toml.

Slučte následující nastavení do souboru. Nechte model a model_provider na nejvyšší úrovni, před jakýmikoli hlavičkami tabulek, a zachovejte nesouvisející nastavení.

model = "<catalog>.<schema>.<model-name>"
model_provider = "databricks"

[model_providers.databricks]
name = "Databricks"
base_url = "https://<workspace-hostname>/ai-gateway/codex/v1"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
http_headers = { Authorization = "Bearer <databricks-pat>" }

Nahraďte zástupce modelu jeho plným názvem Unity Catalog, <workspace-hostname> vaším názvem hostitele pracovního prostoru a <databricks-pat> vaším osobním přístupovým tokenem. Tento příklad ukládá token lokálně; soubor si nechte soukromý a používejte svůj vlastní token.

Spusťte codex z adresáře projektu nebo znovu otevřete desktopovou aplikaci. Pokud má vaše zařízení nastavená spravovaná poskytovatele, požádejte administrátora o jejich aktualizaci; tato nastavení mají přednost před touto uživatelskou konfigurací.

Podrobnosti o poli najdete v referenční dokumentaci ke konfiguraci OpenAI.

Přidat nástroje MCP

Použijte Unity Gateway CLI

Spusť tento příkaz a vyber služby, které chceš přidat:

ug mcp add

Restartuj Codex nebo desktopovou aplikaci a pak ji požádej, aby použila připojený nástroj. ug registruje lokální proxy, které autentizuje požadavky a obnovuje přihlašovací údaje.

Ručně konfigurujte MCP služby

Přidejte následující k ~/.codex/config.toml:

[mcp_servers.dbsql]
url = "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql"
http_headers = { Authorization = "Bearer <databricks-pat>" }

Nahraďte název hostitele a token a pak restartujte Codex. Pro jinou službu použijte unikátní název pod mcp_servers a nahraďte system.ai.dbsql ho jejím třídílným názvem Unity Catalog.

Pro nastavení OAuth postupujte podle instrukcí OpenAI pro autentizaci MCP a zaregistrujte aplikaci Azure Databricks OAuth s přesnou URL, kterou Codex používá.

Přidání dovedností

Použijte Unity Gateway CLI

Spusťte interaktivní výběr:

ug skills add

Nebo si stáhnout konkrétní publikovanou dovednost:

ug skills add --names <catalog>.<schema>.<skill-name>

Restartujte Codex nebo desktopovou aplikaci. Stažené dovednosti jsou dostupné lokálně v ~/.agents/skills/. Spusť stažení znovu, abys získal aktualizovanou verzi.

Chcete-li ukázat dovednosti schématu přes MCP, použijte místo toho:

ug skills add --location <catalog>.<schema> --mcp

Registr dovedností připojit ručně

Přidejte následující k ~/.codex/config.toml:

[mcp_servers.databricks-skill-registry]
url = "https://<workspace-hostname>/ai-gateway/skills/"
http_headers = { Authorization = "Bearer <databricks-pat>" }

Nahraďte název hostitele a token. Ponechte koncové lomítko v adrese URL. Restartujte Codex a požádejte ho, aby použil publikovanou dovednost, například Use <catalog>.<schema>.<skill-name> to review this query.

Registr načítá instrukce dovedností přes MCP. Chcete-li nainstalovat skilly, které již máte, umístěte celou složku skillu, včetně SKILL.md a přibalených souborů, do ~/.agents/skills/.

Dovednosti Unity Gateway jsou v beta verzi. Viz Govern skills pro zpřístupnění a oprávnění.

Troubleshooting

Desktopová aplikace stále žádá o přihlášení přes OpenAI: Na macOS nebo Linuxu spusťte ug configure --agents codex interaktivně a dokončete aktualizaci systémové konfigurace. Samotný CLI profil nekonfiguruje desktopovou aplikaci. Pro ruční nastavení zkontrolujte, že se model_provider nachází v nejvyšší úrovni a requires_openai_auth = false v tabulce poskytovatelů. Nepřidávejte tento příznak k poskytovateli, který používá tabulku auth pro obnovu tokenů OAuth.

Požadavky selžou s chybou WebSocket: Nastavte supports_websockets = false v tabulce poskytovatelů aktivního Azure Databricks. Pokud tu konfiguraci spravuje váš administrátor, požádejte ho, aby ji aktualizoval. Poté aplikaci restartujte.

Chybí model: Zkontrolujte oprávnění modelu. Nastavte model v aktivní konfiguraci na plný název Unity Catalog a začněte novou konverzaci.

Pokud se nezdaří připojení MCP nebo připojení k dovednosti: Zkontrolujte adresu URL, oprávnění a chybu konektoru. U ručních připojení také zkontrolujte expiraci tokenu. Pro ug problémy s nastavením spusťte ug doctor. Stažená dovednost může zůstat dostupná i v případě, že připojení k registru selže.

Další kroky

  • Last updated on