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

일반 소개

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

기능 목록

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

도움말 사용

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

설치 프로세스

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

python --version

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

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

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

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

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

cd oliva

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

python -m venv .venv

환경을 활성화합니다:

• Windows:

  .venv\Scripts\activate
  

• Mac/Linux:

  source .venv/bin/activate
  

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

uv sync

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

pip install uv

6. 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 사용자 지정 키로 교체합니다.

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

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

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

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

cp .env.example .env

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

9. 데이터베이스 채우기
   를 기준으로 표 형식 의미 검색 튜토리얼 지침에 따라 데이터를 설정하거나 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
  

在界面中输入语音指令，例如“搜索某产品”。

• 시맨틱 검색
  有两种搜索方式：
• 使用 Superlinked：

  make agent-search-by-superlinked
  

• 使用 JSON 文件：

  make agent-search-by-json
  

搜索结果由智能体从 Qdrant 数据库返回。

주요 기능 작동

• 음성 상호작용
  Oliva 支持通过语音输入指令。启动后，在 Agent 놀이터 中点击麦克风图标，说出需求（如“找一款手机”），Deepgram 会将语音转为文本，智能体处理后返回结果。监督者智能体会决定哪个智能体执行任务。
• 다중 지능 협업
  项目采用图状工作流（LangGraph），包含多个节点（如搜索、生成）和条件边。配置文件在 app/agents/langchain/config/ 中，可调整智能体行为。核心逻辑在 app/agents/ 카탈로그.
• 사용자 지정 확장 프로그램
  想增加功能？编辑 app/agents/implementations/ 中的智能体代码。例如，添加新工具需在 app/agents/langchain/tools/ 中定义。

주의

• 确保网络畅通，Livekit 和 Deepgram 需要联网。
• 项目依赖较多，初次配置可能需多次调试。
• 检查 GitHub 提交，确保使用最新代码。

通过以上步骤，你可以完整运行 Oliva 并体验语音控制的搜索功能。

애플리케이션 시나리오

1. 产品信息查询
   用户通过语音询问产品详情，Oliva 从 Qdrant 数据库返回结果，适合电商场景。
2. 기술 학습
   开发者研究多智能体架构，修改代码测试不同工作流。
3. 实时演示
   在会议中展示语音助手功能，突出 AI 协作能力。

QA

1. 语音助手不响应怎么办？
   检查 Livekit 和 Deepgram 的密钥是否正确配置，确保网络连接正常。
2. Qdrant 启动失败怎么办？
   确认 Docker 已运行，端口 6333 和 6334 未被占用。
3. 오프라인에서도 사용할 수 있나요?
   语音功能需联网，搜索功能若数据本地化可离线运行。