Conectar OpenCode

Usa OpenCode con modelos, herramientas MCP y habilidades a través de Unity Gateway. La CLI de Unity Gateway (ug) gestiona el inicio de sesión y la configuración del espacio de trabajo, o puedes configurar la conexión manualmente.

Antes de empezar

Necesitas la URL de tu espacio de trabajo de Azure Databricks y el acceso a los modelos, servicios MCP y habilidades que quieres usar. Para la configuración manual, instala OpenCode y ten un token de acceso personal de Azure Databricks.

Para la configuración manual, sustituye <workspace-hostname> por el nombre de host de tu espacio de trabajo de Azure Databricks y <databricks-pat> por tu token. Utiliza los nombres completos de los modelos disponibles en tu espacio de trabajo y fusiona las entradas de configuración con archivos existentes, manteniendo configuraciones no relacionadas.

Si tu administrador ya ha configurado tu dispositivo, sigue las instrucciones de configuración de tu organización.

Utiliza la CLI de Unity Gateway

Instala ug, y luego ejecuta este comando desde el directorio de tu proyecto:

ug opencode

Selecciona tu espacio de trabajo y inicia sesión cuando te lo pidan. El comando abre OpenCode con los modelos de tu gateway configurados. Empieza a programar, o introduce /models para elegir otro modelo configurado.

Configurar los modelos manualmente

Instala OpenCode y luego fusiona esta configuración en ~/.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
          }
        }
      }
    }
  }
}

Sustituye el nombre del modelo en ambas ubicaciones si eliges otro modelo de Claude. Mantén toolStreaming: false por compatibilidad con la puerta de enlace. Inicia OpenCode con opencode.

Para los modelos Gemini, añade un proveedor independiente usando @ai-sdk/google, la URL base https://<workspace-hostname>/ai-gateway/gemini/v1beta, los mismos campos de autenticación y los nombres de tus modelos Gemini. Consulta la documentación de proveedores de OpenCode.

Para reducir el coste por token en tareas rutinarias, selecciona un modelo código abierto como system.ai.glm-5-2 el tuyo. Consulta gasto de Control.

Añadir herramientas MCP

Utiliza la CLI de Unity Gateway

¡Corre!

ug mcp add --agents opencode

Selecciona tus servicios y luego reinicia con ug opencode.

Configurar los servicios MCP manualmente

Fusiona esta entrada en ~/.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>"
      }
    }
  }
}

Para otro servicio, cambia el nombre del servidor y sustituye system.ai.dbsql por su nombre de tres partes de Unity Catalog. Reinicia OpenCode y pídele que use una herramienta conectada. Consulta la documentación MCP de OpenCode.

ug opencode usa ~/.ucode/opencode-xdg/opencode/opencode.json. Usa ese archivo para entradas manuales de MCP al lanzar a través de ug.

Adición de aptitudes

Utiliza la CLI de Unity Gateway

Descargar habilidades publicadas:

ug skills add

Elige tus habilidades y luego reinicia OpenCode. Lee las descargas de ~/.agents/skills/ y carga las habilidades relevantes mientras trabajas.

Configurar habilidades manualmente

En el caso de los archivos que ya tienes, coloca cada carpeta completa de habilidades en ~/.agents/skills/ o en .opencode/skills/ de tu proyecto. Consulta la documentación de habilidades de OpenCode.

Para acceder al registro de habilidades publicado a través de MCP, añade un segundo servidor usando el ejemplo MCP anterior, ponle databricks-skill-registryel nombre , y configúralo url en https://<workspace-hostname>/ai-gateway/skills/. Mantén la barra de arrastre, la cabecera del portador y oauth: false. Pide al agente que use una habilidad con su nombre completo.

Las habilidades de Unity Gateway están en Beta. Consulta Habilidades de Gobierno para habilitación y permisos.

Troubleshooting

Falla una solicitud de modelo: Comprueba la URL de la pasarela, la expiración del token, el nombre del modelo y los permisos.

Falta un servidor MCP: Reinicia el agente. Si lo configuraste con ug, insíguelo ug opencode para que use los mismos ajustes. Para la configuración manual, comproba ~/.config/opencode/opencode.json y la ficha de portador.

Falta una habilidad descargada: Comprueba que su carpeta completa esté SKILL.md en un directorio compatible. Vuelva a ejecutar ug skills add con las mismas opciones para actualizar las habilidades descargadas.

Para problemas de inicio de sesión o de configuración del ug espacio de trabajo, ejecuta ug doctor.

Pasos siguientes

  • Last updated on