Guida introduttiva a Omnigent

Importante

Omnigent è in Beta. Per la documentazione open source, vedere la documentazione di Omnigent.

Omnigent viene eseguito come distribuzione gestita in Azure Databricks. Il server che coordina le sessioni viene gestito automaticamente e si accede con l'identità dell'area di lavoro Azure Databricks. Questa pagina illustra la configurazione specifica per Azure Databricks. Per ulteriori informazioni sulle funzionalità e sulle capacità di Omnigent, consulta la documentazione open source di Omnigent.

Prerequisiti

Devi avere:

• L'anteprima di Omnigent è stata abilitata per l'area di lavoro. Vedi Gestire le anteprime a livello di area di lavoro.
• Un'area di lavoro in un'area che supporta Databricks Unity AI Gateway. Vedere Disponibilità delle funzionalità di Databricks in base all'area.

Per installare Omnigent usando l'interfaccia della riga di comando, è necessario disporre di:

• Python 3.12+
• Node.js 22 LTS con npm e tmux

Scegliere un host

Omnigent viene sempre eseguito nel server di distribuzione Azure Databricks gestito. Il sistema host che esegue il tuo agente è la tua macchina. Installare l'interfaccia della riga di comando di Omnigent e registrare il portatile o una macchina virtuale come host in modo che gli agenti possano accedere a file, strumenti o reti locali. Un host locale è disponibile solo mentre il computer e il omni host processo sono in esecuzione.

Si accede con l'identità dell'area di lavoro Azure Databricks e le sessioni vengono visualizzate nell'interfaccia utente in cui possono essere condivise con altri utenti dell'area <workspace-url>/omnigent di lavoro.

Avviare Omnigent nel proprio computer

Installare l'interfaccia della riga di comando di Omnigent e registrare il portatile o una macchina virtuale come host. Il computer che registri diventa l'ambiente di esecuzione per i tuoi agenti, quindi scegli il computer che ha accesso agli strumenti, ai file e alla rete di cui il tuo agente ha bisogno. Un host locale è disponibile solo mentre il computer e il omni host processo sono in esecuzione.

1. Installare Omnigent con l'extra databricks, che aggiunge l'integrazione con la piattaforma gestita.

   Installare lo script

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

   UV

   uv tool install "omnigent[databricks]"
   

   Pip

   pip install "omnigent[databricks]"
   

2. Configurare le credenziali del modello. Esegui omni setup:

   omni setup
   

   

3. Le credenziali sono definite per ciascun harness, quindi è necessario selezionare un harness e poi scegliere come fornire le relative credenziali.

   • Per richiamare le API del modello di base dell'area di lavoro, scegliere Databricks e immettere l'URL dell'area di lavoro. Questo consente di accedere all'area di lavoro e instrada le chiamate al modello dell'harness tramite Databricks Unity AI Gateway, quindi non ci sono chiavi API da gestire e lì l'utilizzo è regolato e fatturato.
   • In caso contrario, specificare la propria chiave API, sottoscrizione o gateway.

4. Accedi con la tua identità Azure Databricks e registra la macchina come host Omnigent:

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

5. Nel Web browser passare a <workspace-url>/omnigent.

6. Selezionare Nuova sessione.

7. Apri il selettore host e seleziona la macchina che hai registrato. L'host selezionato determina l'ambiente di esecuzione in cui viene eseguito l'agente, quindi selezionare l'host che ha accesso agli strumenti, ai file e alle esigenze dell'agente.

   

8. Descrivi un'attività nel Composer e inviala per avviare la sessione.

Connettere l'app desktop o l'app per dispositivi mobili

L'app desktop Omnigent è facoltativa e disponibile solo in macOS. Installare l'app desktop, quindi dopo aver creato un host, selezionare Connetti al nuovo server nell'app e immettere l'URL dell'area di lavoro.

L'app Omnigent per dispositivi mobili si connette allo stesso modo. Installarlo dall'App Store o usare l'interfaccia utente Web per dispositivi mobili in qualsiasi browser telefonico, quindi immettere l'URL dell'area di lavoro. Per informazioni dettagliate sull'installazione e la configurazione, vedere la documentazione di Omnigent per dispositivi mobili.

Se l'area di lavoro limita l'accesso alla rete, un amministratore potrebbe dover consentire ai dispositivi mobili di raggiungere l'area di lavoro prima di potersi connettere. Vedere Accesso alla rete mobile.