文档中心

日志服务

AgentLoop

快速入门 AgentLoop

快速入门 AgentLoop

本章节以接入 VeADKV1 大模型观测应用为例，介绍如何快速使用日志服务 AgentLoop，实现数据采集到完成实验观测的操作。

前提条件

类别	说明
地域限制	部署 VeADKV1 的服务器与日志服务为同一地域（Region），确保网络连通。
鉴权方式	取用户火山引擎账号的 AccessKey ID、AccessKey Secret。在火山引擎控制台密钥管理页面获取。推荐使用 IAM 用户密钥，请确认该用户具备相关的操作权限，详情可参考IAM 概述。支持自动创建日志服务资源（Project/App/Topic），并自动生成日志主题 ID。
资源配置	已创建源端日志项目和日志主题，且已配置键值类型索引。已创建目标端日志项目和日志主题，且已配置索引。

一接入 VeADKV1 日志应用

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择 AgentLoop > AI观测。

在 AI 观测页面，单击接入 AI 观测。

在接入 AI 观测页面，创建应用。

单击 VeADKV1 图标，选中 VeADKV1 应用。

配置接入应用参数，然后单击创建应用。

参数	说明
Region	接入日志应用数据存放的地域。
日志项目	选择存放日志应用数据的日志项目。说明日志应用创建成功后，将会在该日志项目中，自动创建携带VEADKV1标签的日志主题，用于存放 trace 数据。该日志主题相关信息如下：日志主题名称：应用名称_trace 分区数量：2 日志存储时长：标准存储 90 天索引：自动配置键值索引。
应用名称	输入 VeADKV1 日志应用的名称。长度为3-64个字符。只能包含中文、小写字母、数字、下划线_和连字符-。不能以连字符-和下划线_开头/结尾。不能tls_、tos_以及部分预留字段开头。
描述	日志应用描述信息。长度限制为0-128个字符。

创建应用后，在接入配置中获取使用指引。

接入方式选择 AK SK 接入。

连接方式根据实际情况，选择公网或火山引擎内网。

在使用指引中，复制自动生成的使用指引。

使用指引示例：

公网
火山引擎内网

//请设置如下环境变量：
ENABLE_TLS=true
OBSERVABILITY_OPENTELEMETRY_TLS_SERVICE_NAME=系统自动填充 trace-topic-id
OBSERVABILITY_OPENTELEMETRY_TLS_REGION=系统自动填充当前地域
VOLCENGINE_ACCESS_KEY=<需手动替换实际 tls-ak>
VOLCENGINE_SECRET_KEY=<需手动替换实际 tls-sk>

二接入 VeADKV1 应用数据

修改使用指引中的鉴权信息。

将已获取的 Access Key ID、Secret Access Key 分别填入使用指引的 AK，SK 中。

将 VeADKV1 观测日志接入至日志应用。

登录部署 VeADKV1 的服务器。

执行使用指引中获取的信息，安装日志服务插件。

插件安装完成后，重启 VeADKV1 服务。

返回日志服务控制台，查看可观测图表数据。

三投递 VeADKV1 应用数据至评测集

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择 AgentLoop > 数据回流。

在数据回流页面，单击创建数据回流任务，进入创建数据回流任务页面。

填写基本配置，并单击下一步：数据源。

配置
说明
任务名称
数据回流任务的任务名称。将自动采用此名称作为定时 SQL 任务名称。
描述
数据回流任务的简单描述。

配置数据源，并单击下一步：数据目标。

数据源

配置	说明
数据源类型	选择数据回流任务的数据源类型：当前仅支持日志服务 TLS。
日志项目	待进行数据回流的原始日志所在的日志项目。
日志主题	待进行数据回流的原始日志所在的日志主题。

过滤规则

配置	说明
回流字段	回流字段来源于数据源索引中的键值字段，支持添加自定义字段。可使用原字段名，或设置别名（别名不能重复）作为导出后的字段名。以下场景必须设置字段别名： JSON 格式字段日志服务预留字段
条件配置	支持通过设置回流字段筛选条件进行过滤，支持设置多条且关系过滤条件。

编写加工规则。

系统自动生成 AgentLoop 加工规则，不建议直接修改。如需新增其他加工规则，可根据页面提示在指定位置填写数据加工规则。

日志服务支持多种 DSL 语法函数，您可以在加工函数页签中单击函数名称，查看语法的说明和示例，还可以一键插入指定语法，快速编写加工规则。支持的语法函数列表请参考函数列表。

测试加工规则。

根据页面提示使用日志主题中的日志数据或指定的测试数据进行测试。单击执行预览，测试加工规则。

调度规则。

配置数据回流任务的调度规则。

配置
说明
开始时间
数据回流任务的调度开始时间，即第一个实例被调度的开始时间。
结束时间
数据回流任务的调度结束时间。

配置目标，并单击提交。

配置	说明
目标 Region	数据回流目标端日志所在的目标 Region。
日志项目	数据回流目标端日志所在的日志项目。
日志主题	数据回流目标端日志所在的日志主题。目标日志主题不可与源日志主题相同。
其他目标	勾选 AgentLoop 评测集，并配置如下参数：评测集方式：选择创建新评测集。目标评测集名称：输入评测集名称。字段映射到评测集：选择原始字段对应的评测集列。

四创建实验完成评测

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择 AgentLoop > 评测 > 实验。

在实验页面的实验列表页签，单击新建实验。

在新建实验页面，根据界面提示完成如下配置。

选择评测集。

参数	说明
评测集	选择评测集。
版本	选择评测集的版本。
最大并发执行条数	设置最大并发执行条数，取值范围 1~20。实验支持并发执行评测集中的条目，但受限于评测对象的并发度和调用评估器的模型 TPM 限制。此处为理想的最大执行条数。

（可选）选择评测对象。

当前暂不支持配置评测对象，可直接跳过。

（可选）添加评估器。

如果跳过评估器配置，实验仅获 Agent 实际输出，适用于人工标注的评测场景。

单击添加评估器，配置如下参数：

参数	说明
名称	选择评估器。
版本	选择评估器的版本。
Prompt 详情	查看 Prompt 详情。
字段映射	评测集字段、评测对象实际输出到评估器字段的映射，用于评估器准确获取输入进行评估。
最大并发执行条数	设置最大并发执行条数，取值范围 1~20。实验支持并发执行评测集中的条目，但受限于评测对象的并发度和调用评估器的模型 TPM 限制。此处为理想的最大执行条数。

确认实验配置。

输入实验名称，确认实验配置，确认无误后，单击发起实验。

五查看评测数据

发起实验后，系统将自动执行评测任务，等待任务运行完成后，可手动刷新页面查看数据明细。

查看数据明细

查看指标统计

最近更新时间：2026.09.08 17:14:28

这个页面对您有帮助吗？

有用

有用

无用

无用