Aller au contenu principal
Dernière mise à jour le

Connecter OpenCode

Utilisez OpenCode avec des modèles, des outils MCP et des compétences via Unity Gateway. La CLI Unity Gateway (ug) gère la connexion et la configuration du workspace, ou vous pouvez configurer la connexion manuellement.

Avant de commencer​

Vous avez besoin de l’URL de votre workspace Databricks et d’un accès aux modèles, services MCP et compétences que vous souhaitez utiliser. Pour une configuration manuelle, installez OpenCode et disposez d’un jeton d’accès personnel Databricks.

Pour une configuration manuelle, remplacez <workspace-hostname> par le Hostname de votre workspace Databricks et <databricks-pat> par votre jeton. Utilisez les noms complets des modèles disponibles dans votre workspace et effectuez un Merge des entrées de configuration dans les fichiers existants, en conservant les paramètres sans rapport.

Si votre administrateur a déjà configuré votre appareil, suivez les instructions de configuration de votre organisation.

Use the Unity Gateway CLI​

Installez ug, puis exécutez cette commande depuis le répertoire de votre projet :

Bash
ug opencode

Sélectionnez votre Workspace et connectez-vous lorsque vous y êtes invité(e). La commande ouvre OpenCode avec vos modèles de passerelle configurés. Start coding, ou entrez /models pour choisir un autre modèle configuré.

Configurer les modèles manuellement​

Installez OpenCode, puis Merge cette configuration dans ~/.config/opencode/opencode.json:

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

Remplacez le nom du modèle aux deux endroits si vous choisissez un autre modèle Claude. Conservez toolStreaming: false pour la compatibilité de la passerelle. start OpenCode avec opencode.

Pour les modèles Gemini, ajoutez un fournisseur distinct à l'aide de @ai-sdk/google, de l'URL de base https://<workspace-hostname>/ai-gateway/gemini/v1beta, des mêmes champs d'authentification et de vos noms de modèles Gemini. Consultez la documentation du fournisseur d'OpenCode.

To cut per-token cost for routine tasks, select an open source model such as system.ai.glm-5-2 as your model. See Control spending.

Ajouter des compétences​

Use the Unity Gateway CLI​

Exécuter :

Bash
ug mcp add --agents opencode

Sélectionnez vos services, puis redémarrez avec ug opencode.

Configurer manuellement les services MCP​

Merge cette entrée dans ~/.config/opencode/opencode.json:

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

Pour un autre service, modifiez le nom du serveur et remplacez system.ai.dbsql par son nom Unity Catalog en trois parties. Redémarrez OpenCode et demandez-lui d’utiliser un outil connecté. Voir la documentation MCP d’OpenCode.

ug opencode utilise ~/.ucode/opencode-xdg/opencode/opencode.json. Utilisez ce fichier pour les entrées MCP manuelles lors du lancement via ug.

Ajouter des compétences​

Use the Unity Gateway CLI​

download des compétences publiées :

Bash
ug skills add

Choisissez vos compétences, puis redémarrez OpenCode. Il lit les téléchargements à partir de ~/.agents/skills/ et charge les compétences pertinentes au fur et à mesure que vous travaillez.

Configurer les compétences manuellement​

Pour les fichiers dont vous disposez déjà, placez chaque dossier de compétences complet dans ~/.agents/skills/ ou dans le dossier .opencode/skills/ de votre projet. Consultez la documentation sur les compétences d'OpenCode.

Pour accéder au registre des compétences publié via MCP, ajoutez un deuxième serveur à l’aide de l’exemple MCP ci-dessus, nommez-le databricks-skill-registry et définissez url sur https://<workspace-hostname>/ai-gateway/skills/. Conservez la barre oblique de fin, l'en-tête du porteur (« bearer ») et oauth: false. Demandez à l'agent d'utiliser une compétence par son nom complet.

Les compétences Unity Gateway sont en bêta. Consultez Régir les compétences pour connaître les conditions d'activation et les autorisations.

Dépannage​

Échec d'une requête de modèle : vérifiez l'URL de la passerelle, l'expiration du jeton, le nom du modèle et les autorisations.

Un serveur MCP est manquant : Redémarrez l'agent. Si vous l'avez configuré avec ug, lancez-le avec ug opencode afin qu'il utilise les mêmes paramètres. Pour la configuration manuelle, vérifiez ~/.config/opencode/opencode.json et le jeton porteur.

Une compétence téléchargée est manquante : vérifiez que son dossier complet contient SKILL.md dans un répertoire pris en charge. Réexécutez ug skills add avec les mêmes options pour refresh les compétences downloaded.

Pour les problèmes de connexion au workspace ou de configuration de ug, exécutez ug doctor.

Étapes suivantes​

Sur cette page