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.

Connetti l'app desktop

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.