日志服务智能助手 TLS Agent 是由日志服务提供的一款智能 AI 工具，通过自然语言交互快速实现日志、指标、链路追踪等数据的快捷查询和智能数据洞察能力。本文档介绍 TLS Agent 的使用方法。

说明

该功能仅支持华北2（北京）、华南1（广州）和华东2（上海）地域。

TLS Agent 生成的内容仅供参考，不能作为决策依据。详细说明，请参考 TLS Agent 服务免责声明和服务使用规则。

## 功能介绍日志服务 TLS Agent 已深度理解日志服务产品控制台，并深度融合日志服务产品文档、最佳实践、常见问题等多类知识文档，形成统一知识底座。用户可通过自然语言，进行多轮对话，既能解答日志服务产品知识，也能直接调用 TLS CLI 完成各类任务创建，实现数据接入、数据洞察、检索分析、资源管理等。创建任务过程和获取分析结果数据时，可随时将相关背景或偏好形成长期记忆并存入统一知识底座，让 TLS Agent 完成自进化，成为真实工作流的智能助手。 |功能 |说明 | |---|---| |统一知识底座 |已深度理解日志服务产品控制台及产品文档。 | |长期记忆 |支持将业务背景、常见问题、资源偏好、排障路径等，通过`/memory`命令形成为长期记忆。 | |产品能力引导 |支持理解上下文和用户意图，提供后续操作引导。 | |可执行工作环境 |支持调用 TLS CLI，执行查询、分析结果、生成图表、链路分析等操作。 | ## 使用场景日志服务 TLS Agent 使用场景多样，包括但不限于： |使用场景 |说明 | |---|---| |产品咨询 |* 用于解答日志服务产品功能、检索语法、数据加工函数等。

* 用于解答控制台字段含义、索引配置是否生效、下一步如何操作等。 | |新手入门 |用于引导新手入门，从数据接入、日志检索、日志统计分析、日志排障等角度，逐步理解日志服务的功能。 | |可观测分析 |* 用于将日志数据可视化，帮助用户快速了解日志数据的趋势、分布、异常等。

* 用于从单条日志定位到系统现象，结合索引与查询结果解释异常趋势，进一步走向聚合、统计和影响面判断。 | |日志排障 |* 用于自动分析当前日志中的异常，并自动生成排障报告，帮助用户快速定位问题。

* 用于将排障资料，历史案例形成长期记忆，统一管理，使智能助手更全面，更专业。 | ## 使用方法 ### 在独立页面使用 Agent * 默认为 Agent 绑定`ServiceRoleForTLS`角色权限，并限定为只读`action`。 * 支持绑定自定义角色，自定义权限范围，详情可参考[通过 IAM 设置日志服务访问权限](https://www.volcengine.com/docs/6470/1261471)章节，授予 [TLS Agent](https://www.volcengine.com/docs/6470/812367#2eb74af6) 中的策略。 #### 操作步骤 1. 登录[日志服务控制台](https://console.volcengine.com/tls)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，单击智能助手图标，进入智能助手交互页面。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/726f3d4f62be4d369470c092a6c2e684~tplv-goo7wpa0wc-image.image)

说明

首次使用，需根据界面提示，授予访问日志服务只读资源权限，勾选用户协议，然后开通服务。

4. 在智能助手交互页面，即可自定义需求方案。 * 单击数据洞察、检索分析，资源管理等模块，可一键输入提示词。 * 单击左侧历史任务，可查看历史任务详情。 * 单击界面右上角编辑图表，可配置 IAM 权限，替换绑定的角色。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c809ca39faba4b0295f2f6ec6eca92e3~tplv-goo7wpa0wc-image.image) #### 结果示例示例回答仅做参考，请以实际环境为准。 |操作示例 |示例效果 | |---|---| |查询函数结果示例 |* 输入对话：

```Shell```
``` 原始日志如下：```
``` {```
``` "region": "shanghai"```
``` }```
``` 加工规则如下：```
``` f_set("replace",str_replace(v("region"),"shanghai","上海"))```
``` 返回结果是什么```
``` ```

* 返回结果：

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/97b773317e22422086b54d829b343864~tplv-goo7wpa0wc-image.image) | |查询异常日志示例 |当前地域下，近24小时内，是否存在异常日志。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1269392c335f44bfaec4762cd7dbf5a6~tplv-goo7wpa0wc-image.image) | |可视化分析 |日志项目ID：07b8ec9e\-641b\-xxx，日志主题ID：b45da1b2\-d9bf\-xxx，统计15天内，该主题内出现的告警类型和次数，以扇形图显示并创建一个仪表盘。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1007c4b894b04ab0af5ab68fa7c4c7a7~tplv-goo7wpa0wc-image.image) | ### 在任务流程中使用 Agent 如果您使用的是 IAM 用户，则需先授予 IAM 用户相关权限。详情可参考[通过 IAM 设置日志服务访问权限](https://www.volcengine.com/docs/6470/1261471)章节，授予 [TLS Agent](https://www.volcengine.com/docs/6470/812367#2eb74af6) 中的策略。 |使用场景 |功能说明 |参考 | |---|---|---| |日志采集 |创建 LogCollector 日志采集配置时，支持输入或上传日志样例，使用 TLS Agent 对日志样例进行自动分析，分析完成后可根据提示一键填入相关配置。

* AI 推荐采集模式

* AI 生成正则表达式

* AI 优化正则表达式 |* [单行全文模式](https://www.volcengine.com/docs/6470/93981)

* [多行全文模式](https://www.volcengine.com/docs/6470/103042)

* [JSON 模式](https://www.volcengine.com/docs/6470/103040)

* [分隔符模式](https://www.volcengine.com/docs/6470/93982)

* [单行完整正则模式](https://www.volcengine.com/docs/6470/103041)

* [多行完整正则模式](https://www.volcengine.com/docs/6470/103043)

* [NGINX 配置模式](https://www.volcengine.com/docs/6470/130250) | |日志解读 |获取日志检索分析结果后，支持输入解读要求，系统自动获取当前页面的日志主题信息，主题描述、索引配置、检索分析语句等，并根据原始日志、图表分析进行不同的总结，快速分析日志数据的整体情况。

* AI 总结分析日志

* AI 解读 SQL 逻辑 |[使用 AI 解读分析结果](https://www.volcengine.com/docs/6470/1206704#cfc89ce9) | |生成检索语句 |检索分析日志时，支持利用 LLM 技术将自然语言转换为检索分析语句和通过自然语言解释语句含义。

* AI 生成语句

* AI 解释语句

* AI 使用答疑

* AI 修改语句报错 |[在任务流程中使用 Agent](https://www.volcengine.com/docs/6470/1335026#46286c75) | |生成告警内容 |创建告警内容模版、告警策略时，支持使用 AI 生成通知内容，以及通过界面划词，使用 AI 分析已有内容，并给出优化建议。

* AI 生成通知内容

* AI 优化通知内容 |* [创建告警策略](https://www.volcengine.com/docs/6470/103027)

* [创建内容模板](https://www.volcengine.com/docs/6470/181424) | #### 操作步骤以在检索分析使用智能助手为例，介绍如何使用 TLS Agent 功能。 1. 登录[日志服务控制台](https://console.volcengine.com/tls)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择**常用功能** \> **检索分析**。 4. 在**检索分析**页面的左侧列表中，选择指定的日志项目和日志主题。 5. 在检索分析语句输入框中，单击 AI 语句助手图标，进入 TLS Agent 对话框。 6. 在 TLS Agent 对话框中输入相关需求。 * 简洁模式：直接输入自然语言或语句，系统自动识别问题类型，生成对应的回答。 * 完整模式：支持深度思考和多轮对话优化语句，适合复杂分析需求。

说明

首次使用 TLS Agent 需阅读并同意免责声明和服务使用规则。

支持开启**深度思考**，系统将展示思考的问题类型和思考过程。常见功能如下： |功能 |说明 |示例 | |---|---|---| |生成语句 |输入自然语言，自动转换为检索分析语句。 |* 输入：查询最大的请求时间

* 生成：`* \| SELECT MAX(ReqTime) AS max_reqtime` | |解释语句 |输入检索分析语句，自动解释含义。 |* 输入：`* \| SELECT COUNT(ReqTime) WHERE ReqTime > 40.0`

* 生成：这个 TLS 语句用于统计请求时间超过40毫秒的日志数量。 | |使用答疑 |解答日志服务产品使用相关问题。 |* 输入：日志服务 COUNT 函数使用说明及示例

* 生成：返回函数介绍、使用说明、示例、注意事项和参考文档链接。 | |修改语句报错 |提供语句报错修复建议。 |* 输入：`SELECT count(*)`

* 生成：返回修改后的语句`* \| SELECT count(*)`、语句解释、相关说明。 | #### 结果示例示例回答仅做参考，请以实际环境为准。 * 检索分析 Agent 示例 |操作示例 |示例效果 | |---|---| |转换自然语言为检索分析语句 |* 单轮对话：

查询 `__process_start_time__` 大于等于 1000 的日志。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9cf438647a0248b7a4e6a9440791d7ce~tplv-goo7wpa0wc-image.image)

* 多轮对话：

1. 分析不同请求方法对应的总请求时间，请求方法字段为 Method，请求时间字段为 Reqtime。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/903572320d884828ac56a66a5a5c532f~tplv-goo7wpa0wc-image.image)

2. 再继续分析 POST 请求方法在 P99 百分位的请求时间。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a2e337ed3ace4894a44f857a3660d29c~tplv-goo7wpa0wc-image.image)

3. 尝试使用更复杂的指令：统计各请求方法对应的最大请求时间以及最小请求时间，然后再计算这两个请求时间的差值。需要在检索分析结果中展示各个请求方法、最大请求时间、最新请求时间以及差值。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7e54e202d82845d68168f135d3fbc9a6~tplv-goo7wpa0wc-image.image) | |解释检索分析语句 |输入复杂的检索分析语句，将概括语句含义以及各个子句的具体含义。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6180fe2727dd478fb9c4cc372411cd7f~tplv-goo7wpa0wc-image.image) | |查询日志服务功能 |查询日志服务 AVG 函数说明及使用示例。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/75d21accb4b04a438fc1e9900883e245~tplv-goo7wpa0wc-image.image) | |修复错误语句 |执行错误语句后，可以单击错误信息中的**查看修改建议**，在 TLS Agent 中获取对应的修改建议。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c693c5c2794c4646be8f24fd3df713a9~tplv-goo7wpa0wc-image.image) | * 其他场景使用 Agent 示例 |操作示例 |示例效果 | |---|---| |在**日志采集**使用 Agent 示例 |创建 LogCollector 日志采集配置时，支持输入或上传日志样例，使用 TLS Agent 对日志样例进行自动分析，分析完成后可根据提示一键填入相关配置。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/388dc04105844edd8d428f0d1780745b~tplv-goo7wpa0wc-image.image) | |在**日志解读**使用 Agent 示例 |获取日志检索分析结果后，支持输入解读要求，系统自动获取当前页面的日志主题信息，主题描述、索引配置、检索分析语句等，并根据原始日志、图表分析进行不同的总结，快速分析日志数据的整体情况。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c845b175cf2e40348858a81dd90dd495~tplv-goo7wpa0wc-image.image) | |在**告警**使用 Agent 示例 |创建告警内容模版、告警策略时，支持使用 AI 生成通知内容，以及通过界面划词，使用 AI 分析已有内容，并给出优化建议。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/bfe92efe10664617b1055d69c6225527~tplv-goo7wpa0wc-image.image) |