Connect OpenCode

Gebruik OpenCode met modellen, MCP-tools en vaardigheden via Unity Gateway. De Unity Gateway CLI (ug) verzorgt het aanmelden bij de werkruimte en de configuratie ervan, of je kunt de verbinding handmatig configureren.

Prerequisites

Je hebt je Azure Databricks workspace-URL nodig en toegang tot de modellen, MCP-services en vaardigheden die je wilt gebruiken. Voor handmatige installatie installeer OpenCode en gebruik een Azure Databricks persoonlijke toegangstoken.

Voor handmatige configuratie vervang <workspace-hostname> het met de hostnaam van je Azure Databricks workspace en <databricks-pat> met je token. Gebruik volledige modelnamen die beschikbaar zijn in je werkruimte en voeg configuratie-entries samen met bestaande bestanden, waarbij je niet-gerelateerde instellingen behoudt.

Als je beheerder je apparaat al heeft geconfigureerd, volg dan de installatie-instructies van je organisatie.

Gebruik de Unity Gateway CLI

Installeer ugen voer vervolgens dit commando uit vanuit je projectmap:

ug opencode

Selecteer je werkruimte en meld je aan wanneer daarom wordt gevraagd. Het commando opent OpenCode met je gatewaymodellen geconfigureerd. Begin met coderen, of ga in /models om een ander geconfigureerd model te kiezen.

Modellen handmatig configureren

Installeer OpenCode en voeg deze configuratie samen in ~/.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
          }
        }
      }
    }
  }
}

Vervang de modelnaam op beide locaties als je een ander Claude-model kiest. Behoud toolStreaming: false voor gateway-compatibiliteit. Begin OpenCode met opencode.

Voor Gemini-modellen voeg je een aparte provider toe met , @ai-sdk/googlebasis-URL https://<workspace-hostname>/ai-gateway/gemini/v1beta, dezelfde authenticatievelden en de namen van je Gemini-model. Zie de documentatie van OpenCode voor providers.

Om de kosten per token voor routinetaken te verlagen, kies je een open source-model zoals system.ai.glm-5-2 jouw model. Zie Control-uitgaven.

Voeg MCP-tools toe

Om system.ai.sandbox, system.ai.web_search of system.ai.dbsql te gebruiken, moet een accountbeheerder de Unity Gateway-bèta inschakelen via de pagina Previews van de accountconsole. Zie Accountpreviews beheren.

Gebruik de Unity Gateway CLI

Uitvoeren:

ug mcp add --agents opencode

Selecteer je diensten en start dan opnieuw met ug opencode.

Configureer MCP-services handmatig

Voeg deze vermelding samen in ~/.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>"
      }
    }
  }
}

Voor een andere dienst verander je de servernaam en vervang je system.ai.dbsql door de driedelige Unity Catalog-naam ervan. Start OpenCode opnieuw en vraag het om een verbonden tool te gebruiken. Zie de MCP-documentatie van OpenCode.

ug opencode gebruikt ~/.ucode/opencode-xdg/opencode/opencode.json. Gebruik dat bestand voor handmatige MCP-vermeldingen bij het starten door ug.

Vaardigheden toevoegen

Gebruik de Unity Gateway CLI

Download gepubliceerde vaardigheden:

ug skills add

Kies je vaardigheden en start OpenCode opnieuw op. Het leest de downloads van ~/.agents/skills/ en laadt relevante vaardigheden terwijl je werkt.

Configureer vaardigheden handmatig

Voor bestanden die je al hebt, plaats je elke volledige skillmap in ~/.agents/skills/ of in de map .opencode/skills/ van je project. Zie de documentatie over vaardigheden van OpenCode.

Om toegang te krijgen tot het gepubliceerde vaardigheidsregister via MCP, voeg je een tweede server toe met het MCP-voorbeeld hierboven, noem deze databricks-skill-registry, en stel url je in op https://<workspace-hostname>/ai-gateway/skills/. Behoud de afsluitende slash, de Bearer-header en oauth: false. Vraag de agent om een vaardigheid te gebruiken met de volledige naam.

Unity Gateway-vaardigheden bevinden zich in de bètafase. Zie Vaardigheden beheren voor inschakelen en machtigingen.

Troubleshooting

Een modelverzoek faalt: Controleer de gateway-URL, tokenvervaldatum, modelnaam en permissies.

Er ontbreekt een MCP-server: Herstart de agent. Als je het hebt geconfigureerd met ug, start het met ug opencode zodat het dezelfde instellingen gebruikt. Controleer voor handmatige installatie ~/.config/opencode/opencode.json en de bearer-token.

Een gedownloade vaardigheid ontbreekt: Controleer of de volledige map SKILL.md bevat en zich in een ondersteunde map bevindt. Speel ug skills add opnieuw met dezelfde opties om gedownloade vaardigheden te verversen.

Voor aanmeldings- of installatieproblemen met de werkruimte, voer ug doctor uit.

Volgende stappen 

  • Laatst bijgewerkt om