创建工具以增强智能体能力--安全运营智能体-火山引擎

文档中心

导航

创建工具以增强智能体能力

最近更新时间：2025.11.18 15:49:22首次发布时间：2025.08.20 19:01:03

安全运营智能体需要从您的第三方云平台获取相关数据，以增强其研判能力和运营处置能力。由于三方工具平台众多，如果通过人工逐个对接和开发，过程将非常繁琐且耗时。安全运营智能体支持基于 API 文档快速创建工具，更便捷地获取风险上下文。
本操作手册旨在指导用户如何创建和配置安全运营智能体工具，通过 API 自动生成工具的方式，提高工具创建的效率和兼容性。

使用场景

您可以创建不同的工具用于不同上下文获取场景，例如：

资产信息查询：调用接口快速查询和管理云上资产信息
历史告警数据分析：分析指定资产的历史告警数据，发现潜在的安全风险
情报查询：查询安全情报，了解最新的安全威胁和漏洞

前提条件

您已经准备好对应信息完整、准确的 API 文档，确保需要上传的 API 文档中包含：

鉴权方式：应具备详细的签名认证说明，包括认证方式、鉴权参数和示例等，确保工具能正常调用 API。
接口说明：应包含必要的接口名称、请求方法和参数名称（请求参数和返回参数）等。

创建流程

步骤一上传 API 文件

将不同的 API 文件上传至安全运营智能体，平台会自动解析文件中的 API 内容，为工具生成提供数据基础。

API 文件要求

支持上传多个 API 文件，但待上传的文件需要满足以下要求：

内容要求：
- 上传的 API 与预期生成的工具功能强相关，避免工具自动生成的代码中出现错误或者逻辑不准确。
- API 文件内容应当完整准确，必须包含以下内容：
  - 鉴权方式：应具备详细的签名认证说明，包括认证方式、鉴权参数和示例等，例如火山引擎签名方法。
  - 接口说明：应包含必要的接口名称、请求方法和参数名称（请求参数和返回参数）等。

规格要求：

文档类型		规格
非结构化文档	pdf	350 MB，5000页
	doc	350 MB
	docx	350 MB
	pptx	350 MB
	markdown	5 MB
	txt	5 MB
	faq.xlsx	50 sheet，文件行数总和 30000 行
结构化文档	jsonl	30000 行
	csv	50 sheet，文件行数总和 30000 行
	xlsx	50 sheet，文件行数总和 30000 行

操作步骤

登录火山引擎安全运营智能体控制台。
在页面左侧导航栏，选择设置中心 > 工具管理。
单击 API 文件上传。
单击添加产品。
输入目标产品名称，用于标识工具的第三方云厂商来源。
例如，您可以输入“火山-云服务器”。
单击添加文件。
上传工具相关的 API 文件至平台。
说明
上传预计耗时数分钟，请等待文件解析成功后再进行工具配置。
查看文件解析状态，确保文件解析成功。

步骤二新建工具

待文件上传成功后，就可以通过文件生成对应工具了。

在工具管理页面，单击右上角新建工具。
配置工具基本信息。
- 工具名称：自定义工具的名称，可用于区分不同功能的工具。建议使用接口对应的功能作为工具名称。
- 来源产品：选择步骤一上传 API 文件创建的产品（火山-云服务器），平台自动展示产品关联的 API 文件。
填写工具描述。
安全运营智能体将通过工具描述理解工具用途，生成并调用工具。因此，描述应清晰明确地说明工具的功能和用途。例如“这是一个告警外联信息查询工具，可以根据eip信息查询告警的外联信息。”

单击参数自定义配置，添加输入参数和鉴权参数，支持配置多个输入参数和鉴权参数。以下是参数配置说明和相关示例。

参数类型	字段	说明	示例值
输入参数	参数名称	输入参数的名称，该名称可以与您上传的 API 文件中对应参数不一致，但建议使用符合参数定义的字段名称。	InstanceName
	参数类型	参数的数据类型，支持 string 或 int 类型。	string
	参数说明	表明参数的用途，方便模型理解。	实例名称，用于区分不同的实例
	默认值	填写默认值以确保接口可以正常调用。	ins-12345
	是否必填	如果该参数为调用接口的必填参数，则需要开启必填。	必填
鉴权参数	参数名称	鉴权参数的名称，例如 ak、sk、authorization 等	ak
	参数类型	参数的数据类型，支持 string 或 int 类型。	string
	参数说明	表明参数的用途，方便模型理解。	火山主账户 ak
	默认值	填写默认值以确保接口可以正常调用。	AKLTZ****