Commencez avec les agents de codage

Unity Gateway connecte des agents de codage tels que Claude Code, Codex et OpenCode à des modèles provenant de multiples fournisseurs, des outils MCP et des compétences partagées. Choisissez un modèle pour la tâche, donnez à votre agent accès aux données de l’entreprise, et utilisez les flux de travail de votre équipe.

Vous pouvez vous connecter de deux façons :

  • Utilisation ug (recommandée) : Installez la interface de code Unity Gateway, connectez-vous et lancez votre agent préféré. ug gère les paramètres de connexion spécifiques à l’agent et applique la configuration de votre organisation, ce qui vous permet de commencer à coder sans modifier les fichiers de configuration ni écrire de scripts de configuration.
  • Configurez vous-même la connexion : Entrez le point de terminaison de passerelle et les paramètres d’authentification dans votre agent. Consultez Agents de codage supportés pour choisir votre agent et ouvrir son guide pour la configuration sur le bureau et la ligne de commande.

Ce guide explique comment utiliser ug.

Note

Si votre administrateur a déjà installé ug et configuré votre appareil, allez directement au lancement de votre agent.

Prerequisites

Tu as besoin de:

  • L’URL de votre espace de travail Azure Databricks et l’accès aux modèles que vous souhaitez utiliser. Demandez à votre administrateur si vous n’avez pas ces documents.
  • Python 3.12 ou ultérieur et uv.
  • Un droit à un espace de travail : accès à l’espace de travail ou accès grand public. Consultez Gérer les droits d’utilisation.

Mettez en place et exécutez votre agent

Installer ug

Dans votre terminal, exécutez :

uv tool install git+https://github.com/databricks/unity-gateway

Pour vérifier l’installation, exécutez :

ug --version

Le numéro de version installé doit s’afficher.

Lancez votre agent

Ouvrez un terminal dans votre répertoire de projet. Exécutez la commande pour l’agent que vous souhaitez utiliser :

Claude Code

ug claude

Codex

ug codex

Gemini CLI

ug gemini

OpenCode

ug opencode

GitHub Copilot CLI

ug copilot

Pi

ug pi

Lors de la première utilisation, suivez les instructions pour sélectionner votre espace de travail et vous connecter. ug gère la connexion à Unity Gateway, puis ouvre l’agent choisi avec la même interface et le même flux de travail que vous connaissez déjà. Vous pouvez commencer à l’utiliser tout de suite.

Pour changer de modèle pendant une session, choisissez /model parmi ceux disponibles via votre organisation.

Ajouter des outils et des compétences

Dans votre terminal, exécutez :

ug mcp add
ug skills add

Choisissez les serveurs MCP et les compétences que vous souhaitez ajouter parmi ceux auxquels vous avez accès. Les outils MCP connectent votre agent aux données et aux services ; les compétences fournissent des instructions pour des tâches spécifiques.

Ensuite, lance ou redémarre ton agent pour utiliser ce que tu as ajouté :

Commande dans votre agent Ce que vous pouvez faire
/mcp Consultez les serveurs MCP que vous avez ajoutés et leur état de connexion.
/skills Parcourez les compétences que vous avez ajoutées et sélectionnez-en une pour votre tâche.

Les commandes slash varient d’un agent à l’autre. Consultez le menu d’aide pour les commandes relatives au modèle, au MCP et aux compétences. Voir Ajouter des outils et compétences pour plus d’options de configuration.

Vérifier votre utilisation

Dans votre terminal, exécutez :

ug usage

Vous verrez combien vous avez dépensé et combien de votre budget vous avez utilisé.

Étapes suivantes