Aller au contenu principal

Commencez avec les agents de codage

Unity Gateway connects coding agents such as Claude Code, Codex, and OpenCode to models from multiple providers, MCP tools, and shared skills. Choose a model for the task, give your agent access to company data, and use your team's workflows.

You can connect in two ways:

  • Utilisez ug (recommandé) : installez la CLI Unity Gateway, connectez-vous et lancez votre agent de prédilection. ug gère les paramètres de connexion spécifiques à l’agent et applique la configuration de votre organisation, ce qui vous permet de start à coder sans modifier de fichiers de configuration ni rédiger de scripts d’installation.
  • Configurez vous-même la connexion : entrez le endpoint de la passerelle et les paramètres d'authentification dans votre agent. Consultez Supported coding agents pour choisir votre agent et ouvrir son guide de configuration pour le bureau et la CLI.

Ce guide vous accompagne dans l'utilisation de ug.

remarque

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

Avant de commencer

You need:

  • Your Databricks workspace URL and access to the models you want to use. Ask your admin if you don't have these.
  • Python 3,12 ou version ultérieure et uv.

1. Installez ug

Dans votre terminal, exécutez :

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

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

Bash
ug --version

Vous devriez voir le numéro de version installé.

2. Lancez votre agent

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

Bash
ug claude

On first use, follow the prompts to select your workspace and sign in. ug handles the connection to Unity Gateway, then opens your chosen agent with the same interface and workflow you already know. You can start using it right away.

Pour changer de modèle au cours d’une session, utilisez /model pour faire votre choix parmi ceux qui sont mis à disposition par votre organisation.

3. Add tools and skills

Dans votre terminal, exécutez :

Bash
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 à des données et à des services ; les compétences fournissent des instructions pour des tâches spécifiques.

Lancez ensuite ou redémarrez votre agent pour utiliser ce que vous avez ajouté :

Commande au sein de votre agent

Ce que vous pouvez faire

/mcp

Affichez les serveurs MCP que vous avez ajoutés ainsi que leur état de connexion.

/skills

Parcourez les compétences que vous avez ajoutées et sélectionnez-en une pour votre tâche.

Commande au sein de votre agent

Ce que vous pouvez faire

/mcp

Affichez les serveurs MCP que vous avez ajoutés ainsi que 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 par barre oblique varient selon l'agent. Consultez son menu d'aide pour connaître les commandes relatives aux modèles, au MCP et aux compétences. Consultez la page Add tools and skills pour plus d'options de configuration.

4. Vérifiez votre utilisation

Dans votre terminal, exécutez :

Bash
ug usage

You'll see how much you've spent and how much of your budget you've used.

Étapes suivantes