Démarrage rapide Omnigent

info

Bêta

Omnigent est en bêta. Pour la documentation open source, consultez la documentation Omnigent.

Omnigent s'exécute comme un déploiement géré sur Databricks. Le serveur qui coordonne vos sessions est géré pour vous, et vous vous connectez avec votre identité Databricks Workspace. Cette page couvre la configuration spécifique à Databricks. Consultez la documentation open source d'Omnigent pour plus d'informations sur les fonctionnalités et les capacités d'Omnigent.

Prérequis

Vous devez avoir :

• L’aperçu **Omnigent** est activé pour votre workspace. Voir Gérer les aperçus au niveau du workspace.
• Un Workspace dans une région qui prend en charge Databricks Unity AI Gateway. Voir la disponibilité des fonctionnalités Databricks par région.

Pour installer Omnigent à l'aide de la CLI, vous devez avoir :

• Python 3.12 et versions ultérieures
• Node.js 22 LTS avec npm et tmux

Choisissez un hôte

Omnigent s'exécute toujours sur votre serveur de déploiement Databricks géré. L'hôte qui exécute votre agent est votre propre machine. Vous installez l’Omnigent CLI et enregistrez votre ordinateur portable ou une VM en tant qu’hôte afin que les agents puissent accéder aux fichiers, outils ou réseaux locaux. Un hôte local est disponible uniquement lorsque votre machine et le processus omni host sont en cours d’exécution.

Vous vous connectez avec votre identité de Workspace Databricks, et vos sessions apparaissent dans l'UI <workspace-url>/omnigent où elles peuvent être partagées avec d'autres utilisateurs du Workspace.

Lancez Omnigent sur votre propre machine

Installez l'Omnigent CLI et enregistrez votre ordinateur portable ou une VM en tant qu'hôte. La machine que vous enregistrez devient l'environnement d'exécution de vos agents, alors choisissez la machine qui a accès aux outils, aux fichiers et au réseau dont votre agent a besoin. Un hôte local est disponible uniquement tant que votre machine et le processus omni host sont en cours d'exécution.

1. Installer Omnigent avec l'extra databricks, qui ajoute l'intégration de la plateforme gérée.

Install script

Bash

curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra "databricks"

UV

Bash

uv tool install "omnigent[databricks]"

Pip

Bash

pip install "omnigent[databricks]"

2. Configurez les identifiants du modèle. Exécution omni setup:

   Bash

   omni setup

   

3. Les informations d'identification sont limitées par harnais, vous devez donc sélectionner un harnais, puis choisir comment fournir ses informations d'identification.

   • Pour appeler les APIs de modèles de fondation de votre Workspace, choisissez Databricks et entrez l'URL de votre Workspace. Cela vous connecte au Workspace et achemine les appels de modèle de ce harnais via la Unity AI Gateway de Databricks, de sorte qu'il n'y a pas de clés API à gérer et que l'utilisation y est régie et facturée.
   • Sinon, fournissez votre propre clé API, abonnement ou passerelle.

4. Connectez-vous avec votre identité Databricks et enregistrez la machine en tant qu'hôte Omnigent :

   Bash

   omni login <workspace-url>
   omni host --server <workspace-url>

5. Dans votre navigateur web, accédez à <workspace-url>/omnigent.

6. Sélectionnez Nouvelle session .

7. Ouvrez le sélecteur d’hôte et sélectionnez la machine que vous avez enregistrée. L'hôte que vous sélectionnez détermine l'environnement d'exécution dans lequel l'agent s'exécute, alors choisissez l'hôte qui a accès aux outils, aux fichiers et au réseau dont votre agent a besoin.

   

8. Décrire une tâche dans le compositeur et l'envoyer pour start la session.

Connectez l'application de bureau ou l'application mobile

L'application de bureau Omnigent est facultative et uniquement disponible sur macOS. Installez l'application de bureau, puis après avoir créé un hôte, sélectionnez Connecter à un nouveau serveur dans l'application et entrez l'URL de votre Workspace.

L'application mobile Omnigent se connecte de la même manière. Installez-le depuis l'App Store ou utilisez l'interface utilisateur web mobile dans n'importe quel navigateur de téléphone, puis saisissez l'URL de votre Workspace. Pour les détails d'installation et de configuration, consultez la documentation mobile Omnigent.

Si votre Workspace restreint l'accès réseau, un administrateur peut avoir besoin d'autoriser les appareils mobiles à atteindre le Workspace avant que vous ne puissiez vous connecter. Consultez Accès réseau mobile.