Подключить Codex

Используйте Codex в терминале или в десктопном приложении ChatGPT с моделями, инструментами MCP и навыками через Unity Gateway. Используйте Unity Gateway CLI (ug) для настройки доступа или ручной настройки соединения.

Перед тем как начать

Вам нужен URL вашего рабочего пространства Azure Databricks и доступ к моделям, сервисам MCP и навыкам, которые вы хотите использовать. Установите последнюю версию Codex или десктопное приложение ChatGPT.

Если ваш администратор уже настроил устройство, следуйте инструкциям по запуску вашей организации.

Кодекс в терминале

Установите ug, затем выполните эту команду из вашей директории проекта:

ug codex

Следуйте инструкциям, чтобы выбрать рабочее место и войти. ug настраивает соединение и открывает Codex в вашем терминале. Начните работать с теми же подсказками и командами, которые уже используете. Чтобы сменить модель, введите /model.

Чтобы добавить инструменты или навыки MCP, выполните следующие команды в терминале, затем перезапустите Codex:

ug mcp add
ug skills add

Каждая команда позволяет выбрать, что добавить. Для ручной настройки используйте разделы конфигурации ниже.

Рабочий стол ChatGPT

На macOS и Linux установите ug и выполните эту команду в интерактивном терминале:

ug configure --agents codex

Выберите рабочее место и войдите в систему. Если вас запросят, одобрите обновление конфигурации системы паролем вашего устройства. ug настраивает соединение Unity Gateway и обновление токена OAuth.

Откройте или перезапустите приложение для компьютера и начните диалог в Codex. Используйте средство выбора модели, чтобы переключаться между моделями. Команда ug codex открывает агент терминала; открывает десктопное приложение нормально после настройки.

В Windows используйте ручную конфигурацию модели ниже. Вы по-прежнему можете использовать ug mcp add и ug skills add для добавления инструментов и навыков, а затем перезапустить приложение.

Настройка моделей вручную

Эти настройки применимы как к агенту терминала, так и к десктопному приложению. Закройте Codex, затем откройте или создайте ~/.codex/config.toml. В системе Windows используется команда %USERPROFILE%\.codex\config.toml.

Объедините следующие настройки с файлом. Держите model и model_provider на верхнем уровне, до любых заголовков таблиц, и сохраняйте несвязанные настройки.

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>" }

Замените заполнитель модели на его полное имя в Unity Catalog, <workspace-hostname> — на имя хоста вашего рабочего пространства, а <databricks-pat> — на ваш личный токен доступа. В этом примере токен хранится локально; файл сохраняется приватным и используется ваш собственный токен.

Запустите codex из папки проекта или заново откройте десктопное приложение. Если у вашего устройства есть управляемые настройки провайдера, попросите администратора обновить их; эти настройки имеют приоритет над этой пользовательской конфигурацией.

См. справочник конфигурации OpenAI для подробностей поля.

Добавить инструменты MCP

Используйте Unity Gateway CLI

Выполните эту команду и выберите нужные сервисы:

ug mcp add

Перезагрузите Codex или десктопное приложение, затем попросите использовать подключённый инструмент. ug регистрирует локальный прокси, который аутентифицирует запросы и обновляет учетные данные.

Настройка MCP-сервисов вручную

Добавьте следующую строку в файл ~/.codex/config.toml:

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

Замените имя хоста и токен, затем перезапустите Codex. Для другого сервиса используйте уникальное имя под mcp_servers и замените system.ai.dbsql на его трёхкомпонентное имя в Unity Catalog.

Для настройки OAuth следуйте инструкциям по аутентификации MCP от OpenAI и зарегистрируйте приложение Azure Databricks OAuth с точным URL обратного вызова, который используется в Codex.

Добавление навыков

Используйте Unity Gateway CLI

Запустите интерактивный пикер:

ug skills add

Или скачайте конкретный опубликованный навык:

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

Перезагрузите Codex или десктопное приложение. Скачанные навыки доступны локально в ~/.agents/skills/. Запустите загрузку заново, чтобы получить обновлённую версию.

Чтобы показать навыки схемы через MCP, запустите:

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

Подключите реестр навыков вручную

Добавьте следующую строку в файл ~/.codex/config.toml:

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

Замените имя хоста и токен. Сохраните завершающий слеш в URL. Перезапусти Codex и попроси использовать опубликованный навык, например Use <catalog>.<schema>.<skill-name> to review this query.

Реестр загружает инструкции навыков через MCP. Чтобы установить уже имеющиеся у вас файлы навыков, поместите полную папку навыков, включая SKILL.md и комплектные файлы, в ~/.agents/skills/.

Навыки Unity Gateway — в бета-версии. См. раздел «Управление навыками » для поддержки и разрешений.

Troubleshooting

Десктопное приложение всё ещё запрашивает вход в систему OpenAI: На macOS или Linux перезапустите ug configure --agents codex игру интерактивно и завершите обновление конфигурации системы. Профиль CLI сам по себе не настраивает десктопное приложение. При ручной настройке проверьте, что model_provider находится на верхнем уровне, а requires_openai_auth = false — в таблице провайдеров. Не устанавливайте этот флаг для поставщика, использующего таблицу auth для обновления токенов OAuth.

Запросы завершаются с ошибкой WebSocket: Установите supports_websockets = false в таблице активного поставщика Azure Databricks. Если администратор управляет этой конфигурацией, попросите его обновить её. После этого перезапусти приложение.

Отсутствует модель: Проверьте права доступа к модели. В активной конфигурации model установите полное имя Unity Catalog и начните новый диалог.

Соединение MCP или навыков не работает: Проверьте URL, разрешения и ошибку коннектора. Для ручного подключения также проверьте истечение срока действия токенов. При ug проблемах с настройкой запустите ug doctor. Загруженный навык может оставаться доступным даже в случае неудачного подключения к реестру.

Дальнейшие действия

  • Last updated on