Omnigent – příručka rychlého startu

Important

Omnigent je v beta verzi. Open source dokumentaci najdete v dokumentaci Omnigent.

Omnigent běží jako spravované nasazení na Azure Databricks. Server, který koordinuje relace, se spravuje za vás a přihlásíte se pomocí identity pracovního prostoru Azure Databricks. Tato stránka popisuje nastavení specifické pro Azure Databricks. Další informace o funkcích a možnostech omnigent najdete v opensourcové dokumentaci Omnigent .

Předpoklady

Musíte mít:

• Omnigent Preview je pro váš pracovní prostor povolený. Viz Správa náhledů na úrovni pracovního prostoru.
• Pracovní prostor v regionu, který podporuje Databricks Unity Gateway. Podívejte se na dostupnost funkcí Databricks podle oblastí.

Pokud chcete nainstalovat Omnigent pomocí rozhraní příkazového řádku, musíte mít:

• Python 3,12 nebo novější
• Node.js 22 LTS včetně npm a tmux

Vyberte hostitele

Omnigent vždy běží na vašem spravovaném serveru nasazení Azure Databricks. Počítač, na kterém běží váš agent, je váš vlastní počítač. Nainstalujete Omnigent CLI a zaregistrujete přenosný počítač nebo virtuální počítač jako hostitele, aby agenti měli přístup k místním souborům, nástrojům nebo sítím. Localhost je dostupný pouze tehdy, když běží váš počítač i proces omni host.

Přihlásíte se pomocí identity pracovního prostoru Azure Databricks a vaše relace se zobrazí v uživatelském <workspace-url>/omnigent rozhraní, kde je můžete sdílet s ostatními uživateli pracovního prostoru.

Spuštění Omnigentu na vlastním počítači

Nainstalujte Omnigent CLI a zaregistrujte přenosný počítač nebo virtuální počítač jako hostitele. Počítač, který zaregistrujete, se stane spouštěcím prostředím pro vaše agenty, takže vyberte počítač, který má přístup k nástrojům, souborům a síťovým potřebám agenta. Localhost je dostupný pouze tehdy, když běží váš počítač i proces omni host.

1. Nainstalujte Omnigent s doplňkem databricks, který přidává integraci se spravovanou platformou.

   Instalace skriptu

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

   UV

   uv tool install "omnigent[databricks]"
   

   Jádro

   pip install "omnigent[databricks]"
   

2. Nastavte přihlašovací údaje modelu. Spustit omni setup:

   omni setup
   

   

3. Přihlašovací údaje jsou vázány na konkrétní harness, takže musíte nejprve vybrat harness a potom zvolit, jak jeho přihlašovací údaje zadat.

   • Pokud chcete vyvolat rozhraní API základního modelu pracovního prostoru, zvolte Databricks a zadejte adresu URL pracovního prostoru. Tím se přihlásíte do pracovního prostoru a modelové volání tohoto zařízení se směrují přes Databricks Unity Gateway, takže nejsou žádné API klíče ke správě a používání je tam regulováno a fakturováno.
   • V opačném případě zadejte vlastní klíč rozhraní API, předplatné nebo bránu.

4. Přihlaste se pomocí své identity Azure Databricks a zaregistrujte počítač jako hostitele Omnigent:

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

5. Ve webovém prohlížeči přejděte na <workspace-url>/omnigent.

6. Vyberte Nová relace.

7. Otevřete nástroj pro výběr hostitele a vyberte počítač, který jste zaregistrovali. Vybraný hostitel určuje spouštěcí prostředí, ve kterém se agent spouští, takže vyberte hostitele, který má přístup k nástrojům, souborům a síti, které agent potřebuje.

   

8. Popište úkol v nástroji Composer a odešlete jej ke spuštění relace.

Připojení desktopové aplikace nebo mobilní aplikace

Desktopová aplikace Omnigent je volitelná a dostupná jenom v systému macOS. Nainstalujte desktopovou aplikaci a potom po vytvoření hostitele vyberte Připojit k novému serveru v aplikaci a zadejte adresu URL pracovního prostoru.

Mobilní aplikace Omnigent se připojuje stejným způsobem. Nainstalujte ho z App Storu nebo použijte mobilní webové uživatelské rozhraní v libovolném telefonním prohlížeči a zadejte adresu URL pracovního prostoru. Podrobnosti o instalaci a nastavení najdete v mobilních dokumentech Omnigent.

Pokud váš pracovní prostor omezuje přístup k síti, správce možná bude muset povolit, aby se mobilní zařízení dostala k pracovnímu prostoru, než se budete moct připojit. Viz Mobilní přístup k síti.