Подключить OpenCode

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

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

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

Для ручной настройки замените <workspace-hostname> на имя узла рабочей области Azure Databricks, а <databricks-pat> — на ваш токен. Используйте полные имена моделей, доступные в вашем рабочем пространстве, и объединяйте записи конфигурации с существующими файлами, сохраняя несвязанные настройки.

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

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

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

ug opencode

Выберите рабочее пространство и войдите в систему по запросу. Команда открывает OpenCode с настроенными моделями шлюзов. Начните программировать или введите /models , чтобы выбрать другую настроенную модель.

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

Установите OpenCode, затем объедините эту конфигурацию в ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "databricks-anthropic/system.ai.claude-sonnet-4-6",
  "provider": {
    "databricks-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://<workspace-hostname>/ai-gateway/anthropic/v1",
        "apiKey": "<databricks-pat>",
        "headers": {
          "Authorization": "Bearer <databricks-pat>"
        }
      },
      "models": {
        "system.ai.claude-sonnet-4-6": {
          "options": {
            "toolStreaming": false
          }
        }
      }
    }
  }
}

Замените название модели в обоих местах, если выбираете другую модель Claude. Сохраните toolStreaming: false для совместимости со шлюзами. Начните OpenCode с opencode.

Для моделей Gemini добавьте отдельного провайдера, указав @ai-sdk/google, базовый URL https://<workspace-hostname>/ai-gateway/gemini/v1beta, те же поля аутентификации и имена ваших моделей Gemini. См. документацию провайдера OpenCode.

Чтобы снизить стоимость одного токена для рутинных задач, выберите в качестве модели модель с открытым исходным кодом, например system.ai.glm-5-2. См. контрольные расходы.

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

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

Запуск:

ug mcp add --agents opencode

Выберите свои услуги, затем начните с ug opencode.

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

Объединим эту запись в ~/.config/opencode/opencode.json:

{
  "mcp": {
    "dbsql": {
      "type": "remote",
      "url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      }
    }
  }
}

Для другого сервиса измените имя сервера и замените system.ai.dbsql его на трёхчастное название Unity Catalog. Перезапусти OpenCode и попроси использовать подключённый инструмент. См. документацию OpenCode по MCP.

ug opencode использует ~/.ucode/opencode-xdg/opencode/opencode.json. Используйте этот файл для ручного ввода записей MCP при запуске через ug.

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

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

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

ug skills add

Выберите свои навыки, затем перезапустите OpenCode. Считывает данные из ~/.agents/skills/ и загружает соответствующие навыки в процессе работы.

Настраивайте навыки вручную

Если у вас уже есть нужные файлы, поместите каждую полную папку навыка в ~/.agents/skills/ или в папку .opencode/skills/ вашего проекта. См. документацию по навыкам OpenCode.

Чтобы получить доступ к опубликованному реестру навыков через MCP, добавьте второй сервер, используя приведённый выше пример MCP, назовите databricks-skill-registryего и установите url на https://<workspace-hostname>/ai-gateway/skills/. Оставьте задний слэш, заголовок носителя и oauth: false. Попросите агента использовать навык по его полному названию.

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

Troubleshooting

Запрос модели не работает: Проверьте URL шлюза, срок истечения токена, имя модели и разрешения.

Отсутствует MCP-сервер: Перезагрузите агент. Если вы настроили его с помощью ug, запустите его с помощью ug opencode, чтобы использовались те же настройки. Для ручной настройки проверьте ~/.config/opencode/opencode.json и токен Bearer.

Отсутствует скачанный навык: Проверьте , что полная папка находится SKILL.md в поддерживаемой папке. Перезапускайте ug skills add с теми же опциями для обновления скачанных навыков.

При проблемах со входом в рабочую область или ug настройкой запустите ug doctor.

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

  • Last updated on