스킬 레지스트리
에이전트 인프라공개 스킬

Search Engine

AI 에이전트를 위한 전문 검색 — 전체 텍스트 및 의미 기반 검색, 쿼리, 인덱스, 벡터 검색, 자동완성, 순위 디버그, 동의어 관리, 검색 분석.

이 스킬이 가르치는 것

특정 작업 유형을 위한 재사용 가능한 플레이북입니다.

MCP 서버는 에이전트에게 어떤 작업이 가능한지 알려줍니다. 스킬은 그 작업들에 대한 판단을 추가합니다: 작업을 인식하는 방법, 따라야 할 순서, 피해야 할 것, 그리고 결과가 완료되었는지 결정하는 방법.

검색 작업을 조율합니다 — 전문 검색, 벡터/의미 검색, 자동완성, 인덱스 관리, 동의어 설정, 검색 분석을 수행합니다. 문서 검색, 검색 인덱스 구축, 의미 쿼리 실행, 동의어 관리, 검색 성능 분석 또는 순위 디버깅 시 사용하세요.

아키텍처

Search Engine이(가) ADK-Rust 에이전트를 어떻게 안내하는지.

스킬은 서비스 자격 증명이나 비즈니스 데이터를 포함하지 않고 지침만 포함하므로 읽기 쉽고 휴대 가능합니다. ADK-Rust가 에이전트에 제공하고, 에이전트는 검토된 도구 경계에서 선택하며, 연결된 MCP 서버가 인증된 작업을 수행합니다.

01

사용자 요청

에이전트는 일반 언어로 표현된 목표를 받습니다.

02

Search Engine 스킬

의도를 일치시키고 결정 가이드를 제공하며 도구 경계를 좁힙니다.

03

ADK-Rust 에이전트

워크플로우를 계획하고 각 의미 있는 단계를 런타임을 통해 스트리밍합니다.

04

mcp-search

기능을 소유한 시스템에 대해 인증된 작업을 실행합니다.

05

검증된 결과

스킬의 완료 규칙은 사용자에게 반환되는 증거를 형성합니다.

휴대 가능한 지침: SKILL.md · 기능 경계: mcp-search · 허용된 도구: 20

결정 가이드

에이전트가 요청을 올바른 작업으로 전환하는 방법입니다.

이 경로들은 스킬 지침에서 직접 가져온 것입니다. 모델이 의도를 인식하고 전체 기능 범위 대신 집중된 도구나 워크플로우를 선택하도록 돕습니다.

01

"search", "find", "query"?

search (전체 텍스트) 또는 semantic_search (의미 기반)

02

"similar", "like this", "related"?

find_similar / query_vectors

03

"autocomplete", "suggest"?

suggest

04

"index", "add document", "ingest"?

index_document / upsert_vectors

05

"create index", "schema"?

create_index

06

"why ranked", "explain", "debug"?

explain_ranking / test_query

07

"analytics", "performance", "zero results"?

get_search_analytics

08

"synonyms"?

get_synonyms / update_synonyms

검증된 워크플로우

유용한 결과를 위한 반복 가능한 시퀀스입니다.

워크플로우는 여러 도구 호출을 사용자가 실제로 인식하는 작업으로 결합합니다. 스킬은 순서와 의도된 결과를 설명하며 ADK-Rust는 공유 런타임을 통해 에이전트의 진행 상황을 스트리밍합니다.

011개의 호출

전문 검색

필터가 적용된 키워드 검색

021개의 호출

의미 검색

의미 기반(벡터) 검색

031개의 호출

문서 인덱싱

인덱스에 추가/업데이트

042개의 호출

순위 디버깅

문서 순위 설명

052개의 호출

관련성 개선

검색 결과 없음 → 동의어 추가

06Best For개의 호출

모드

도구

도구 경계

스킬은 20개의 문서화된 도구를 사용할 수 있습니다.

이 허용 목록은 스킬에서 선언합니다. 에이전트가 이 작업에 필요한 행동에 집중하도록 유지하며, mcp-search는 인증, 검증, 연결된 시스템에 대한 책임을 집니다.

search
semantic_search
multi_search
suggest
find_similar
list_indexes
get_index
create_index
index_document
delete_document
upsert_vectors
query_vectors
list_namespaces
get_vector_stats
get_search_analytics
get_index_stats
explain_ranking
test_query
get_synonyms
update_synonyms

작동 규칙

에이전트가 해야 할 것

  • 사용자 의도가 키워드보다 중요할 때 semantic_search 사용
  • 제로 결과 쿼리는 get_search_analytics로 정기 점검
  • 결과가 없는 일반 용어는 동의어 추가
  • 예상치 못한 순위는 explain_ranking으로 디버깅

운영 경계

에이전트가 피해야 할 것

  • 모호하거나 개념적 쿼리에 전문 검색 대신 의미 검색 사용
  • 검색 가능한 필드를 지정하지 않고 인덱싱하지 마세요
  • 제로 결과 쿼리를 무시하지 마세요(갭 신호)

설치 및 연결

기능이 기대하는 스킬을 그 옆에 추가하세요.

ADK-Rust 스킬 로더가 발견할 수 있는 저장소에 설치하고, mcp-search에 연결하며, 선언된 도구가 사용 가능한지 확인한 후 에이전트에게 워크플로우 사용을 요청하세요.

스킬 설치
git clone https://github.com/zavora-ai/skill-search-engine.git \
  ~/.skills/skills/search-engine
ADK-Rust 로딩 형태
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("search-engine").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

저장소의 호환성 선언: mcp-search 서버 연결 필요(Meilisearch, Typesense, Elasticsearch, Pinecone 또는 커스텀).

공식 문서

완전한 스킬 패키지를 읽어보세요.

저장소는 정확한 지침, 예제, 헬퍼 스크립트, 자산, MCP 요구사항, 라이선스, 이후 업데이트에 대해 권위 있는 출처로 남아 있습니다.

소스 기록

이 스킬 항목의 저장소 메타데이터입니다.

공개 저장소 보기 ↗
라이선스
Apache-2.0
허용된 도구
20
참조
3
수정
b72a8a4f88bd
업데이트됨
2026년 5월 31일