올리바: 음성 제어 다중 지능 제품 검색 도우미

10.7K 00

일반 소개

Oliva는 Deluxer에서 개발한 오픈 소스 다중 지능 비서 도구로 GitHub에 공개되어 있습니다. Oliva는 Deluxer가 GitHub에서 개발한 오픈 소스 다중 지능 지원 도구로, 여러 AI 지능의 협업을 통해 사용자가 Qdrant 데이터베이스에서 제품 정보를 검색할 수 있도록 도와줍니다. Oliva는 개발자나 연구자에게 적합하며 사용자가 다운로드, 수정 및 배포할 수 있도록 코드가 완전히 공개되어 있습니다. 실용적인 도구일 뿐만 아니라 다중 지능 아키텍처에 대해 배울 수 있는 플랫폼이기도 합니다. 이 프로젝트는 다음과 같은 최신 기술 스택에 의존합니다. Livekit 와 딥그램은 실시간 음성 상호작용을 지원합니다.

기능 목록

음성 제어 검색: 사용자가 음성으로 명령을 입력하면 인텔리전트 바디가 검색 작업을 완료합니다.
다중 지능 협업: 여러 AI 지능이 처리 작업을 분담하고, 슈퍼바이저 지능이 이를 조정합니다.
시맨틱 검색 지원: 랭체인과 슈퍼링크를 기반으로 정확한 콘텐츠 검색을 가능하게 합니다.
오픈 소스 코드: 전체 코드가 제공되며 사용자가 자유롭게 기능을 수정하고 확장할 수 있습니다.
로컬 또는 클라우드 배포: 로컬 또는 높은 유연성을 갖춘 서버에서 실행할 수 있도록 지원합니다.

도움말 사용

올리바는 GitHub 기반의 오픈 소스 프로젝트이므로 사용하기 전에 환경 및 종속성을 구성해야 합니다. 다음은 빠르게 시작하는 데 도움이 되는 자세한 설치 및 사용 가이드입니다.

설치 프로세스

Python 환경 준비하기
Oliva에는 Python 3.12 이상이 필요합니다. 버전을 확인하세요:

python --version

올바른 버전이 없는 경우 Python 웹사이트로 이동하여 다운로드하여 설치하세요.

복제 프로젝트
https://github.com/Deluxer/oliva 을 열고 '코드' 버튼을 클릭한 후 HTTPS 링크를 복사하여 실행합니다:

git clone https://github.com/Deluxer/oliva.git

먼저 Git을 설치해야 하며, 다운로드 주소는 Git 공식 웹사이트입니다.

프로젝트 디렉토리로 이동
다운로드하여 폴더로 이동합니다:

cd oliva

가상 환경 만들기
종속성 충돌을 방지하려면 가상 환경을 만드는 것이 좋습니다:

python -m venv .venv

환경을 활성화합니다:

Windows:
```
.venv\Scripts\activate
```
Mac/Linux:
```
source .venv/bin/activate
```

종속성 설치
활용 uv 도구 동기화 종속성:

uv sync

이렇게 하면 가상 환경이 자동으로 생성되고 LangChain, Superlinked 등과 같은 모든 종속성이 설치됩니다. 없는 경우 uv를 클릭하고 먼저 설치합니다:

pip install uv

Qdrant 데이터베이스 구성
Docker로 Qdrant를 실행합니다:

docker run -p 6333:6333 -p 6334:6334 -e QDRANT__SERVICE__API_KEY=your_api_key -v "$(pwd)/qdrant_storage:/qdrant/storage:z" qdrant/qdrant

먼저 Docker를 설치해야 하며, 다음에서 다운로드하세요: Docker 공식 웹사이트. 설치 후 your_api_key 사용자 지정 키로 교체합니다.

Livekit 계정 설정하기
존재 라이브킷 클라우드 다음 정보를 등록하세요:

LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=your_key
LIVEKIT_API_SECRET=your_secret

이 값을 환경 변수에 저장합니다.

환경 변수 구성
예제 파일을 복사하여 편집합니다:

cp .env.example .env

존재 .env 파일은 Livekit과 딥그램 (딥그램은 딥그램 공식 웹사이트 (액세스하려면 등록하세요).

데이터베이스 채우기
를 기준으로 표 형식 의미 검색 튜토리얼 지침에 따라 데이터를 설정하거나 assets/snapshot.zip 스냅샷을 Qdrant에 저장합니다.

주요 기능

음성 어시스턴트 실행하기
프로젝트 디렉토리에서 실행합니다:

make oliva-start

그러면 음성 어시스턴트 서비스가 시작됩니다. Qdrant 및 Livekit이 실행 중인지 확인합니다.

프런트엔드 인터페이스에 연결하기
인터뷰 상담원 플레이그라운드Livekit 프로젝트가 있는 경우 Livekit 프로젝트 자격 증명을 입력하여 어시스턴트에 연결합니다. 또는 로컬에서 실행하세요:

클론(외래어) 에이전트 플레이그라운드 창고::

git clone https://github.com/livekit/agents-playground.git

종속 요소를 설치하고 시작하세요:
```
npm install
npm run start
```

인터페이스에 "제품 검색"과 같은 음성 명령을 입력합니다.

시맨틱 검색
검색하는 방법에는 두 가지가 있습니다:
슈퍼링크를 사용합니다:
```
make agent-search-by-superlinked
```
JSON 파일을 사용합니다:
```
make agent-search-by-json
```

검색 결과는 Qdrant 데이터베이스의 인텔리전스에 의해 반환됩니다.

주요 기능 작동

음성 상호작용
Oliva는 음성으로 명령 입력을 지원합니다. 시작 후 에이전트 놀이터 딥그램에서 마이크 아이콘을 클릭하고 원하는 것을 말하면(예: "휴대폰 찾기") 딥그램이 음성을 텍스트로 변환하고, 인텔리전스가 이를 처리하여 결과를 반환합니다. 슈퍼바이저 인텔리전스는 어떤 인텔리전스가 작업을 수행할지 결정합니다.
다중 지능 협업
이 프로젝트는 여러 노드(예: 검색, 생성)와 조건부 에지가 포함된 그래픽 워크플로(LangGraph)를 사용합니다. 구성 파일은 app/agents/langchain/config/ 지능적인 신체 동작을 조정할 수 있습니다. 의 핵심 로직은 app/agents/ 카탈로그.
사용자 지정 확장 프로그램
기능을 추가하고 싶으신가요? 편집 app/agents/implementations/ 를 스마트 바디 코드에 추가해야 합니다. 예를 들어 새 도구를 추가하려면 스마트 바디 코드에 app/agents/langchain/tools/ 에 정의되어 있습니다.

주의

인터넷 연결 상태가 양호한지 확인하세요. Livekit과 Deepgram은 인터넷 연결이 필요합니다.
프로젝트에는 많은 종속성이 있으며 초기 구성에는 여러 번의 디버깅 세션이 필요할 수 있습니다.
최신 코드를 사용하고 있는지 GitHub 커밋을 확인합니다.

이 단계를 통해 Oliva를 완전히 실행하고 음성 제어 검색 기능을 경험할 수 있습니다.

애플리케이션 시나리오

제품 정보 문의
사용자가 음성으로 제품 세부 정보를 요청하면 Oliva는 이커머스 시나리오에 적합한 Qdrant 데이터베이스에서 결과를 반환합니다.
기술 학습
개발자는 다중 인텔리전트 바디 아키텍처를 연구하고 코드를 수정하여 다양한 워크플로를 테스트합니다.
라이브 데모
회의에서 음성 어시스턴트 기능을 시연하여 AI 협업 기능을 강조하세요.

QA

음성 어시스턴트가 응답하지 않으면 어떻게 해야 하나요?
Livekit 및 Deepgram 키가 올바르게 구성되었는지 확인하고 네트워크 연결이 제대로 작동하는지 확인합니다.
Qdrant가 시작되지 않으면 어떻게 해야 하나요?
Docker가 실행 중이고 포트 6333 및 6334가 사용 중이 아닌지 확인합니다.
오프라인에서도 사용할 수 있나요?
음성 기능을 사용하려면 인터넷 연결이 필요하며, 데이터가 현지화된 경우 검색 기능을 오프라인으로 실행할 수 있습니다.