Anslut ChatGPT desktopappen

Använd Codex-agenten i ChatGPT Desktop med modeller, MCP-verktyg och funktioner via Unity Gateway. ChatGPT-prenumerationer stöds inte via Unity Gateway.

Prerequisites

Du behöver URL:en till din Azure Databricks-arbetsyta, tillgång till de modeller och verktyg du vill använda samt den senaste versionen av ChatGPT Desktop.

Om din administratör redan har konfigurerat din enhet, följ organisationens startinstruktioner.

Installera ug, kör sedan detta kommando i en interaktiv terminal:

ug configure --agents codex

Välj din arbetsplats och logga in. Detta kommando konfigurerar både Codex CLI och den installerade ChatGPT-skrivbordsarbetsagenten för samma arbetsyta. Om du blir tillfrågad, godkänn systemkonfigurationsuppdateringen med ditt enhetslösenord. ug konfigurerar Unity Gateway-anslutningen och OAuth-tokenuppdatering.

På Windows kör du kommandot från en terminal med administratörsbehörighet. ChatGPT-skrivbordet på Windows kräver Codex 0.156.0 eller senare för att tillämpa konfigurationen.

Öppna eller starta om ChatGPT-skrivbordsappen och starta sedan en Codex-konversation. Använd modellväljaren för att byta modell.

Lägg till MCP-verktyg och färdigheter

Använd ug för att lägga till MCP-servrar och färdigheter som finns tillgängliga via din arbetsyta:

ug mcp add --agents codex
ug skills add

Öppna eller starta om ChatGPT-skrivbordsappen efter konfiguration. Ange /mcp för att kontrollera MCP-anslutningar. Färdigheter finns tillgängliga från ~/.agents/skills/.

För manuell modellkonfiguration, MCP och färdighetskonfiguration, se Connect Codex. Dessa inställningar gäller både Codex CLI och ChatGPT Desktop.

Limitations

Den här konfigurationen konfigurerar både Codex CLI och ChatGPT skrivbordsapp. Konfigurationen gäller för alla konversationer i båda, och deras inferensrutter går via Unity Gateway.

ChatGPT-skrivbordsappen stödjer öppna modeller via Unity Gateway. Smart routing stöds inte i skrivbordsappen för ChatGPT.

Troubleshooting

  • ChatGPT-skrivbordet ber om OpenAI-inloggning: Kör ug configure --agents codex interaktivt och slutför systemkonfigurationsuppdateringen. På Windows, kör det från en terminal med administratörsbehörighet. CLI-profilen ensam konfigurerar inte ChatGPT-skrivbordet. För manuell installation, kontrollera att det model_provider är på högsta nivån och requires_openai_auth = false finns i leverantörstabellen. Lägg inte till den flaggan i en leverantör som använder en auth tabell för OAuth-tokenuppdatering.

  • En modell saknas: Kontrollera dina modellbehörigheter. Ställ model in dess fullständiga Unity-katalognamn i den aktiva konfigurationen och starta en ny konversation.

  • En MCP- eller skillanslutning misslyckas: Kontrollera URL:en, behörigheterna och anslutningsprogrammets fel. För manuella anslutningar, kontrollera också tokens utgångsdatum. Vid problem med att konfigurera ug, kör ug doctor.

  • Inloggning till arbetsområdet fungerar, men ett verktyg ber dig logga in: Öppna inloggningslänken som returneras av MCP, logga in hos den externa leverantören och försök sedan anropet igen. Arbetsyta och inloggning för leverantör är separata steg.

Nästa steg