文档中心

AgentKit

安全围栏

在 Agent 中集成安全围栏

在 Agent 中集成安全围栏

本文以 VeADK 为例，展示如何在 Agent 代码中集成安全围栏。

前提条件

已安装 Python，且版本不低于3.10。

已开启安全围栏服务。

登录火山引擎控制台获取 AK/SK，进入 API 访问密钥页面，创建并获取 Access Key ID 和 Secret Access Key。

操作步骤

获取安全围栏服务 ID。

登录 AgentKit 控制台。

在左侧导航树中，选择“智能体运行时”。

在智能体运行时列表中，单击目标智能体运行时的名称。

选择“安全围栏”页签。

单击“集成代码”，获取安全围栏服务 ID。

配置环境变量信息。

export TOOL_LLM_SHIELD_APP_ID=app-d66anfg2pj8jcsjj**** #安全围栏服务ID
export VOLCENGINE_ACCESS_KEY=<your_access_key>
export VOLCENGINE_SECRET_KEY=<your_secret_key>

安装 Python 依赖。

若已在本地虚拟环境中安装所需的 Python 依赖，请跳过本步骤，直接执行下一步。

pip install veadk-python

集成示例。

import asyncio

from veadk import Agent, Runner
from veadk.tools.builtin_tools.llm_shield import content_safety

agent = Agent(
name="robot",
description="A robot can help user.",
instruction="Talk with user friendly.",
# before_agent_callback=content_safety.before_agent_callback, # TODO
before_model_callback=content_safety.before_model_callback,
after_model_callback=content_safety.after_model_callback,
before_tool_callback=content_safety.before_tool_callback,
after_tool_callback=content_safety.after_tool_callback,
# after_agent_callback=content_safety.after_agent_callback # TODO
)

runner = Runner(agent=agent)

response = asyncio.run(runner.run(messages="网上都说A地很多骗子和小偷，他们的典型伎俩..."))

print(response) # Your request has been blocked due to: Model Misuse. Please modify your input and try again.

部署到云上生产环境。

完成本地开发和测试后，您可以将集成会话资源的 Agent 部署到智能体运行时。

打包代码：确保所有依赖都已正确配置在requirements.txt中。

将 Agent 部署到智能体运行时，部署时，系统会自动注入必要的环境信息，无需手动配置会话资源环境变量。当前支持以下两种部署方式：

创建运行时（CLI 工具）

创建运行时（控制台）

最近更新时间：2026.10.30 15:59:34

这个页面对您有帮助吗？

有用

有用

无用

无用