Omnigent 빠른 시작

Important

옴니젠트는 베타에 있습니다. 오픈 소스 설명서는 Omnigent 설명서를 참조하세요.

Omnigent는 Azure Databricks 관리되는 배포로 실행됩니다. 세션을 조정하는 서버가 관리되며 Azure Databricks 작업 영역 ID로 로그인합니다. 이 페이지에서는 Azure Databricks 관련된 설정을 다룹니다. Omnigent 기능 및 기능에 대한 자세한 내용은 오픈 소스 Omnigent 설명서를 참조하세요.

사전 요구 사항

필요한 것은 다음과 같습니다.

CLI를 사용하여 Omnigent를 설치하려면 다음이 있어야 합니다.

  • Python 3.12 이상
  • npm 및 tmux가 포함된 Node.js 22 LTS

호스트 선택

Omnigent는 항상 관리되는 Azure Databricks 배포 서버에서 실행됩니다. 에이전트를 실행하는 호스트는 사용자 고유의 컴퓨터입니다. 에이전트가 로컬 파일, 도구 또는 네트워크에 액세스할 수 있도록 Omnigent CLI를 설치하고 랩톱 또는 VM을 호스트로 등록합니다. 로컬 호스트는 컴퓨터와 omni host 프로세스가 실행되는 동안에만 사용할 수 있습니다.

Azure Databricks 작업 영역 ID로 로그인하면 세션이 다른 작업 영역 사용자와 공유할 수 있는 UI에 표시됩니다<workspace-url>/omnigent.

사용자 고유의 컴퓨터에서 Omnigent 시작

Omnigent CLI를 설치하고 랩톱 또는 VM을 호스트로 등록합니다. 등록하는 컴퓨터는 에이전트의 실행 환경이 되므로 에이전트에 필요한 도구, 파일 및 네트워크에 액세스할 수 있는 컴퓨터를 선택합니다. 로컬 호스트는 컴퓨터와 omni host 프로세스가 실행되는 동안에만 사용할 수 있습니다.

  1. 관리형 플랫폼 통합을 추가하는 databricks extra와 함께 Omnigent를 설치하세요.

    스크립트 설치

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

    UV

    uv tool install "omnigent[databricks]"
    

    pip install "omnigent[databricks]"
    
  2. 모델 자격 증명을 설정합니다. 를 실행합니다 omni setup.

    omni setup
    

    터미널에서 옴니 설정을 실행하여 하네스 자격 증명 추가를 시작합니다.

  3. 자격 증명은 하네스별로 범위가 지정되므로 하네스를 선택한 다음 자격 증명을 제공하는 방법을 선택해야 합니다.

    • 작업 영역의 Foundation Model API를 호출하려면 Databricks를 선택하고 작업 영역 URL을 입력합니다. 이렇게 하면 Databricks Unity AI Gateway를 통해 모델 호출을 사용하는 작업 영역 및 경로에 로그인하므로 관리할 API 키가 없으며 사용량이 관리되고 요금이 청구됩니다.
    • 그렇지 않으면 사용자 고유의 API 키, 구독 또는 게이트웨이를 제공합니다.
  4. Azure Databricks ID로 로그인하고 컴퓨터를 Omnigent 호스트로 등록합니다.

    omni login <workspace-url>
    omni host --server <workspace-url>
    
  5. 웹 브라우저에서 <workspace-url>/omnigent로 이동합니다.

  6. 새 세션을 선택합니다.

  7. 호스트 선택기를 열고 등록한 컴퓨터를 선택합니다. 선택한 호스트는 에이전트가 실행되는 실행 환경을 결정하므로 에이전트에 필요한 도구, 파일 및 네트워크에 액세스할 수 있는 호스트를 선택합니다.

    등록된 로컬 호스트가 선택된 Omnigent 작업 영역 UI 호스트 선택기입니다.

  8. 컴포저에서 작업을 설명하고 전송하여 세션을 시작합니다.

데스크톱 앱 연결

Omnigent 데스크톱 앱은 선택 사항이며 macOS에서만 사용할 수 있습니다. 데스크톱 앱을 설치한 다음 호스트를 만든 후 앱에서 새 서버에 연결을 선택하고 작업 영역 URL을 입력합니다.