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 ouvrir Omnigent sur un Databricks Sandbox, vous devez également disposer des éléments suivants :

• Un Workspace dans une région qui prend également en charge Databricks Sandbox. Consulter Limitations.
• L'aperçu Sandbox activé pour votre workspace. Voir Gérer les aperçus au niveau du workspace.

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é. Ce qui diffère est l'hôte qui exécute votre agent :

• Databricks Sandbox (géré) : Databricks provisionne et exécute l'hôte dans le cloud. Il continue de s'exécuter lorsque votre ordinateur portable est éteint, et vos identifiants ne quittent jamais Databricks. Sélectionnez cette option pour start rapidement.
• Votre propre machine (locale) : vous installez l'Omnigent CLI et enregistrez votre ordinateur portable ou une VM en tant qu'hôte. Votre ordinateur portable ou votre VM devient l'environnement d'exécution afin que les agents puissent accéder aux fichiers locaux, aux outils ou aux réseaux. Un hôte local n'est disponible que lorsque votre machine et le processus omni host sont en cours d'exécution.

Vous vous connectez avec votre identité de Workspace Databricks de toute façon, car les deux hôtes passent par le même serveur géré. La visibilité et le partage des sessions sont les mêmes pour les deux : vos sessions apparaissent dans l'interface utilisateur <workspace-url>/omnigent et peuvent être partagées avec d'autres utilisateurs du Workspace, quel que soit l'hôte qui les exécute.

Lancez Omnigent sur un Databricks Sandbox

La manière la plus simple d'exécuter Omnigent est avec un Databricks Sandbox: un hôte cloud géré que Databricks provisionne pour vous. Votre agent s'exécute dans un environnement isolé et reproductible qui reste actif même lorsque votre ordinateur portable est en veille. Les modèles acheminent via les APIs de modèle de base de votre Workspace sur AI Gateway automatiquement, il n'y a donc pas de clés API à gérer et votre utilisation des modèles hérite de la gouvernance et des contrôles d'AI Gateway.

1. Dans votre navigateur web, accédez à <workspace-url>/omnigent.
2. Sélectionnez Nouvelle session .
3. Ouvrez le sélecteur d'hôte et sélectionnez Sandbox .
4. Décrire une tâche dans le compositeur et l'envoyer pour start la session.

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.

Connecter l'application de bureau

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.