Pular para o conteúdo principal
Última atualização em

Conectar o desktop do ChatGPT

Usar o agente Codex no desktop do ChatGPT com modelos, ferramentas MCP e habilidades através do Unity Gateway. As inscrições do ChatGPT não são suportadas através do Unity Gateway.

Pré-requisitos​

Você precisa da URL do seu workspace do Databricks, acesso aos modelos e ferramentas que deseja usar e a versão mais recente do ChatGPT desktop.

Se o seu administrador já configurou o seu dispositivo, siga as instruções de inicialização da sua organização.

Conectar com a CLI do Unity Gateway (Recomendado)​

Instale o ug, em seguida, execução este comando em um terminal interativo:

Bash
ug configure --agents codex

Selecione seu workspace e faça login. Este comando configura o CLI do Codex e o agente de trabalho do ChatGPT desktop instalado para o mesmo workspace. Se solicitado, aprove a atualização da configuração do sistema com sua senha do dispositivo. ug configura a conexão do Unity Gateway e o refresh de token OAuth.

No Windows, faça a execução do comando a partir de um terminal elevado. O ChatGPT Desktop no Windows requer o Codex 0.156.0 ou posterior para aplicar a configuração.

Abra ou reinicie o ChatGPT desktop e, em seguida, comece uma conversa no Codex. Use o seletor de modelos para mudar de modelo.

Adicionar ferramentas e habilidades MCP​

Use ug para adicionar servidores e habilidades MCP disponíveis através do seu workspace:

Bash
ug mcp add --agents codex
ug skills add

Abra ou reinicie o desktop do ChatGPT após a configuração. Insira /mcp para verificar as conexões MCP. As skills estão disponíveis a partir de ~/.agents/skills/.

Para configuração manual de modelos, MCP e habilidades, consulte Conectar Codex. Essas configurações se aplicam ao CLI do Codex e ao ChatGPT desktop.

Limitações​

Essa configuração configura tanto a CLI do Codex quanto o desktop do ChatGPT. A configuração se aplica a todas as conversas em ambos, e suas rotas de inferência através do Unity Gateway.

O desktop do ChatGPT oferece suporte a modelos abertos por meio do Unity Gateway. O Smart Routing não é compatível com o desktop do ChatGPT.

Solução de problemas​

  • O ChatGPT desktop pede login na OpenAI: Execute ug configure --agents codex novamente de forma interativa e conclua a atualização da configuração do sistema. No Windows, execução-o em um terminal elevado. Apenas o perfil do CLI não configura o ChatGPT desktop. Para configuração manual, verifique se model_provider está no nível superior e requires_openai_auth = false está na tabela do provedor. Não adicione esse sinalizador a um provedor que usa uma tabela auth para refresh de tokens OAuth.

  • Um modelo está faltando: Verifique suas permissões de modelo. Defina model para seu nome completo no Unity Catalog na configuração ativa e comece uma nova conversa.

  • Uma conexão MCP ou de habilidade falha: Verifique o URL, as permissões e o erro do conector. Para conexões manuais, verifique também a expiração do token. Para problemas de configuração de ug, execução ug doctor.

  • O log in no workspace funciona, mas uma ferramenta pede que você faça log in: abra o link de log in retornado pelo MCP, faça log in no provedor externo e tente a chamada novamente. O log in no Workspace e no provedor são os passos separados.

Os passos seguintes​

Nesta página