技能注册表
智能体基础设施公共技能

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(全文)或 semantic_search(语义)

02

“相似”、“像这样”、“相关”?

find_similar / query_vectors

03

“自动补全”、“建议”?

suggest

04

“索引”、“添加文档”、“摄取”?

index_document / upsert_vectors

05

“创建索引”、“模式”?

create_index

06

“为什么排名”、“解释”、“调试”?

explain_ranking / test_query

07

“分析”、“性能”、“零结果”?

get_search_analytics

08

“同义词”?

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或自定义)。

源记录

此技能条目的仓库元数据。

查看公共仓库 ↗
许可证
Apache-2.0
允许的工具
20
参考文献
3
修订
b72a8a4f88bd
已更新
2026年5月31日