sls_translate_natural_language_to_query
Convert natural language descriptions into SLS (Log Service) query statements, enabling users to search logs without requiring SLS query syntax knowledge.
Instructions
将自然语言转换为SLS查询语句。
## 功能概述
该工具可以将自然语言描述转换为有效的SLS查询语句,便于用户使用自然语言表达查询需求。
## 使用场景
- 当用户不熟悉SLS查询语法时
- 当需要快速构建复杂查询时
- 当需要从自然语言描述中提取查询意图时
## 使用限制
- 仅支持生成SLS查询,不支持其他数据库的SQL如MySQL、PostgreSQL等
- 生成的是查询语句,而非查询结果,需要配合sls_execute_query工具使用
- 如果查询涉及ARMS应用,应优先使用arms_generate_trace_query工具
- 需要对应的 log_sotre 已经设定了索引信息,如果生成的结果里面有字段没有索引或者开启统计,可能会导致查询失败,需要友好的提示用户增加相对应的索引信息
## 最佳实践
- 提供清晰简洁的自然语言描述
- 不要在描述中包含项目或日志库名称
- 如有需要,指定查询的时间范围
- 首次生成的查询可能不完全符合要求,可能需要多次尝试
## 查询示例
- "帮我生成下 XXX 的日志查询语句"
- "查找最近一小时内的错误日志"
Args:
ctx: MCP上下文,用于访问SLS客户端
text: 用于生成查询的自然语言文本
project: SLS项目名称
log_store: SLS日志库名称
region_id: 阿里云区域ID
Returns:
生成的SLS查询语句
Input Schema
Name | Required | Description | Default |
---|---|---|---|
log_store | Yes | sls log store name | |
project | Yes | sls project name | |
region_id | Yes | aliyun region id,region id format like 'xx-xxx',like 'cn-hangzhou' | |
text | Yes | the natural language text to generate sls log store query |
Input Schema (JSON Schema)
{
"properties": {
"log_store": {
"description": "sls log store name",
"title": "Log Store",
"type": "string"
},
"project": {
"description": "sls project name",
"title": "Project",
"type": "string"
},
"region_id": {
"description": "aliyun region id,region id format like 'xx-xxx',like 'cn-hangzhou'",
"title": "Region Id",
"type": "string"
},
"text": {
"description": "the natural language text to generate sls log store query",
"title": "Text",
"type": "string"
}
},
"required": [
"text",
"project",
"log_store",
"region_id"
],
"title": "sls_translate_natural_language_to_queryArguments",
"type": "object"
}