Query Agent 소개

Query Agent 소개

Query Agent는 Weaviate Cloud 데이터베이스 위에서 **에이전틱 검색(agentic search)**을 수행하는 서비스예요. 자연어로 질문하면, 에이전트가 어떤 컬렉션을 검색할지, 어떤 필터·정렬을 적용할지, 어떤 검색 유형을 쓸지를 한 번의 호출로 자동 결정해요. Weaviate Cloud 전용 기능이에요.

출처: Query Agent 소개

무료 티어: 월 최대 250건의 ask 쿼리 또는 1000건의 search 쿼리, 신용카드 불필요.

가장 빠른 예제

Python의 경우 weaviate.agents.query에서 QueryAgent를 임포트해 컬렉션 목록을 넘기고 qa.ask(...)로 질문하면 끝이에요.

from weaviate.agents.query import QueryAgent

qa = QueryAgent(
    client=client, # your Weaviate cloud client
    collections=["FinancialContracts"]
)

res = qa.ask("Find all contracts signed in 2025")

res.display()

TypeScript에서는 weaviate-agents 패키지의 QueryAgent를 써요.

import { QueryAgent } from 'weaviate-agents';

const qa = new QueryAgent(
    client, // your Weaviate cloud client
    {
        collections: ['FinancialContracts'],
    }
);
const res = await qa.ask("Find all contracts signed in 2025");
res.display();

에이전트 메모리를 찾고 있나요?: Engram은 에이전트에 지속적이고 검색 가능한 메모리를 대화·사용자 간에 제공하는 관리형 메모리 서비스예요.

Query Agent란 무엇인가?

Weaviate Query Agent는 기존 Weaviate 데이터베이스에 연결해 LLM을 사용해 자연어 질의를 실행 가능한 검색으로 변환해요. 한 개 또는 여러 컬렉션에 걸쳐 여러 검색·집계를 수행하며, 하나의 자연어 질문에 따라 검색할 컬렉션, 커스텀 필터, group by, 정렬, 검색 유형을 동적으로 결정해요.

데이터를 위한 사전 구축된 에이전틱 서비스로 설계됐으며, 두 가지 주요 모드가 있어요.

  • Ask Mode: 데이터를 검색한 뒤 자연어 답변을 반환. 채팅처럼 동작하며, 원시 데이터 대신 글로 된 응답을 원하는 엔드유저 향 앱에 가장 적합.
  • Search Mode: 필터·정렬·검색 유형을 자동 선택해 원시 매칭 객체를 그대로 반환. 조회(lookup)처럼 동작하며, 내부 검색, 대시보드, 더 큰 파이프라인의 검색(retrieval) 단계에 적합.

예시 사용 사례

  • 고객용 채팅 어시스턴트 (Ask Mode): "$70 미만 9사이즈 빈티지 신발 추천해줘" 같은 질문에 제품 카탈로그에서 찾아 글로 답변.
  • 내부 대시보드의 자연어 필터 (Search Mode): "지난주 EU 고객이 플래그한 주문"을 필터링된 Weaviate 쿼리로 바꿔 UI에 렌더링.
  • 본인 RAG/에이전트 스택의 검색 단계 (Search Mode): 에이전트로 가장 관련성 높은 객체를 가져온 뒤, 통제하는 다운스트림 생성 단계로 전달.

시작하기

클라우드에서 설정 없이 Query Agent를 써볼 수 있어요. 콘솔의 'Agents' 탭으로 가서 컬렉션의 데이터에 대해 질문하면 돼요. Weaviate Cloud 클러스터(무료 티어는 영구 무료)만 있으면 Python이나 TypeScript 클라이언트로 몇 분 안에 첫 질의를 실행할 수 있어요. 데이터가 없다면 클라우드 콘솔에서 CSV 업로드 또는 Weaviate API로 채우면 돼요.

더 살펴볼 자료

  • Quickstart: 클라이언트 설정 후 첫 ask·search 호출 실행
  • Modes: Ask Mode, Search Mode 등 상세 페이지
  • Configuration: 생성자 옵션, 컬렉션 구성, 추가 필터, 시스템 프롬프트, 대화 입력
  • Recipes: 엔드투엔드 예제 노트북

더 알아보기 (Learn more)