大模型应用防火墙
大模型应用防火墙
- 文档首页
大模型应用防火墙SDK 参考多轮对话检测
复制全文
下载 pdf多轮对话检测
文档反馈
问问助手通过 SDK 传入会话轮次 ID（RunID）和会话 ID（SessionID）后，您可以在攻击日志中按会话维度聚合记录，并追溯完整对话链路。
预期效果
传入 SessionID 和 RunID 后，控制台会展示以下攻击日志效果：
- 在攻击日志列表中展示会话 ID（SessionID）。
- 单击会话 ID，查看该会话关联的全部对话内容。
- 在会话详情中按时间顺序展示每轮请求的 RunID，便于追踪完整链路。
攻击日志列表：展示会话 ID。单击会话 ID 后，您可以查看该会话关联的所有对话内容。
会话详情页：展示会话基本信息、命中规则和会话过程。会话过程中会显示每轮请求的 RunID，用于还原完整对话链路。
注意事项
- SDK 初始化：参考SDK 安装和初始化完成依赖安装和初始化配置。
- 配置防护策略：为资产配置相关防护策略，参考防护策略介绍。
- 接口信息：接口介绍、使用限制以及参数描述，请参考检测输入或输出内容是否合规。
- SDK 版本：各语言 SDK 最低版本要求如下表所示
- 语言最低版本源代码语言最低版本源代码Python5.0.29Java2.0.7Go1.2.30PHP1.0.114
调用接口
调用接口时，请按以下方式传入参数：
- 使用 extensions 传入 RunID 和 SessionID。
- 使用 message 传入当前轮待检测内容。
- 使用 history 传入当前轮之前的会话上下文。
其中：
- SessionID 用于关联同一会话下的多轮请求。
- RunID 用于标识会话中的单次请求。
- history 不包含当前轮的 message。
Python
Java
Go
PHP
# =============================================================================
# 会话级内容审核示例（Python SDK）
# 功能：演示单轮会话检测请求；多轮会话通过业务传入的同一个 SessionID 关联
# =============================================================================
import json
from volcenginesdkllmshield import *
def main():
# ------------------------------------------------------------------
# 1. 连接参数（请替换为自己的真实值）
# ------------------------------------------------------------------
myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com" # 服务端地址，按地域选择
ak = "YOUR AK" # 火山引擎 Access Key
sk = "YOUR SK" # 火山引擎 Secret Key
appid = "app-d8l5k1ivi7p3109****" # 资产 ID（应用 ID），控制台创建
region = "cn-beijing" # 地域，需与服务地址对应
TIMEOUT = 10 # 超时时间（秒）
# ------------------------------------------------------------------
# 2. 创建客户端
# ------------------------------------------------------------------
try:
client = ClientV2(myUrl, ak, sk, region, TIMEOUT)
except Exception as e:
print(f"创建客户端失败: {e}")
return
# ------------------------------------------------------------------
# 3. 构建请求
# message: 本次检测的当前轮消息（role + content）
# history: 当前轮之前的会话上下文，每条包含 role + content
# extensions: 业务传入的扩展字段（RunID 标识本次检测，SessionID 关联多轮会话）
# ------------------------------------------------------------------
request = ModerateV2Request(
scene=appid,
# 本次检测的当前轮消息（命中：敏感数据泄露 - 手机号 + 身份证号）
message=MessageV2(
role="user", # 检测的内容来源，user-用户提示词；assistant-模型响应内容
content="好的，我叫陈*，手机号是1378765****，身份证号440301************，想了解一下入职流程和需要准备的材料。",
content_type=ContentTypeV2.TEXT,
),
# 当前轮之前的会话历史上下文
history=[
MessageV2(
role="system", # 上下文内容来源：system-系统提示词
content="你是一名人力资源助手，负责回答求职者关于招聘、面试和入职流程的咨询。",
content_type=ContentTypeV2.TEXT,
),
MessageV2(
role="user", # 上下文内容来源：user-用户提示词
content="你好，我已经通过了面试，想了解一下入职相关的事宜。",
content_type=ContentTypeV2.TEXT,
),
MessageV2(
role="assistant", # 上下文内容来源：assistant-模型响应内容
content="恭喜你通过面试！请问你想了解入职流程、材料准备还是薪资福利方面的信息呢？",
content_type=ContentTypeV2.TEXT,
),
],
# 扩展字段：RunID 标识本次检测请求，SessionID 用于关联同一会话下的多轮检测
extensions={
ExtensionsKey.RUN_ID: "PYTHON_RUN_ID_001",
ExtensionsKey.SESSION_ID: "PYTHON367898765456721FEAE****",
},
)
# ------------------------------------------------------------------
# 4. 发送审核请求
# ------------------------------------------------------------------
try:
print("请求体:")
print(json.dumps(request.model_dump(by_alias=True),
ensure_ascii=False, indent=2))
except Exception as e:
print(f"打印请求体失败: {e}")
try:
response = client.Moderate(request)
print("\n审核结果:")
if response is None:
print(" 空响应")
else:
print(response.model_dump_json(by_alias=True, indent=2))
except Exception as e:
print(f"请求异常: {e}")
if __name__ == "__main__":
main()
// =============================================================================
// 会话级内容审核示例（Java SDK）
// 功能：演示单轮会话检测请求；多轮会话通过业务传入的同一个 SessionID 关联
// =============================================================================
package org.example;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import com.volcengine.llmshield.*;
public class SessionSingle {
public static void main(String[] args) throws Exception {
String myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com"; // 服务端地址，按地域选择
String ak = "YOUR AK"; // 火山引擎 Access Key
String sk = "YOUR SK"; // 火山引擎 Secret Key
String appid = "app-d8l5k1ivi7p3109v****"; // 资产 ID（应用 ID），控制台创建
String region = "cn-beijing"; // 地域，需与服务地址对应
long connTtlMs = 2000; // 连接超时时间（毫秒）
ApiClient client = ApiClient.New(myUrl, ak, sk, region, connTtlMs, "", 20);
if (client == null) {
System.out.println("创建客户端失败");
return;
}
ModerateV2Request request = new ModerateV2Request();
request.setScene(appid);
MessageV2 message = new MessageV2();
message.setRole("user");
message.setContent("好的，我叫陈*，手机号是1378765****，身份证号440301************，想了解一下入职流程和需要准备的材料。");
message.setContentType(ContentTypeV2.TEXT);
request.setMessage(message);
List<MessageV2> history = new ArrayList<>();
MessageV2 systemMsg = new MessageV2();
systemMsg.setRole("system");
systemMsg.setContent("你是一名人力资源助手，负责回答求职者关于招聘、面试和入职流程的咨询。");
systemMsg.setContentType(ContentTypeV2.TEXT);
history.add(systemMsg);
MessageV2 userMsg = new MessageV2();
userMsg.setRole("user");
userMsg.setContent("你好，我已经通过了面试，想了解一下入职相关的事宜。");
userMsg.setContentType(ContentTypeV2.TEXT);
history.add(userMsg);
MessageV2 assistantMsg = new MessageV2();
assistantMsg.setRole("assistant");
assistantMsg.setContent("恭喜你通过面试！请问你想了解入职流程、材料准备还是薪资福利方面的信息呢？");
assistantMsg.setContentType(ContentTypeV2.TEXT);
history.add(assistantMsg);
request.setHistory(history);
Map<String, String> extensions = new HashMap<>();
extensions.put(ExtensionsKey.RUN_ID, "JAVA_RUN_ID_001");
extensions.put(ExtensionsKey.SESSION_ID, "JAVA367898765456721FEAE****");
request.setExtensions(extensions);
try {
System.out.println("审核结果:");
ModerateV2Response response = client.Moderate(request);
if (response == null) {
System.out.println(" 空响应");
return;
}
System.out.println(response);
} catch (Exception e) {
System.out.println("请求异常: " + e.getMessage());
e.printStackTrace();
}
}
}
// =============================================================================
// 会话级内容审核示例（Go SDK）
// 功能：演示单轮会话检测请求；多轮会话通过业务传入的同一个 SessionID 关联
// =============================================================================
package main
import (
"encoding/json"
"fmt"
"time"
"github.com/volcengine/volcengine-go-sdk/service/llmshield"
)
func main() {
myUrl := "https://cn-beijing.sdk.access.llm-shield.omini-shield.com" // 服务端地址，按地域选择
ak := "YOUR AK" // 火山引擎 Access Key
sk := "YOUR SK" // 火山引擎 Secret Key
appid := "app-d8l5k1ivi7p3109v****" // 资产 ID（应用 ID），控制台创建
region := "cn-beijing" // 地域，需与服务地址对应
timeout := 10 * time.Second // 超时时间
client := llmshield.New(myUrl, ak, sk, region, timeout)
if client == nil {
fmt.Println("创建客户端失败")
return
}
request := llmshield.ModerateV2Request{
Scene: appid,
Message: &llmshield.MessageV2{
Role: "user",
Content: "好的，我叫陈*，手机号是1378765****，身份证号440301************，想了解一下入职流程和需要准备的材料。",
ContentType: llmshield.ContentTypeV2_TEXT,
},
History: []*llmshield.MessageV2{
{
Role: "system",
Content: "你是一名人力资源助手，负责回答求职者关于招聘、面试和入职流程的咨询。",
ContentType: llmshield.ContentTypeV2_TEXT,
},
{
Role: "user",
Content: "你好，我已经通过了面试，想了解一下入职相关的事宜。",
ContentType: llmshield.ContentTypeV2_TEXT,
},
{
Role: "assistant",
Content: "恭喜你通过面试！请问你想了解入职流程、材料准备还是薪资福利方面的信息呢？",
ContentType: llmshield.ContentTypeV2_TEXT,
},
},
Extensions: map[string]string{
llmshield.ExtensionsKey_RunID: "GO_RUN_ID_001",
llmshield.ExtensionsKey_SessionID: "GO3678987654567898765456721FEAE****",
},
}
fmt.Println("请求体:")
if requestJSON, err := json.MarshalIndent(request, "", " "); err != nil {
fmt.Printf("打印请求体失败: %v\n", err)
} else {
fmt.Println(string(requestJSON))
}
response, err := client.Moderate(&request)
fmt.Println("\n审核结果:")
if err != nil {
fmt.Printf("请求异常: %v\n", err)
return
}
if response == nil {
fmt.Println(" 空响应")
return
}
fmt.Printf("%s\n", response.String())
}
<?php
// =============================================================================
// 会话级内容审核示例（PHP SDK）
// 功能：演示单轮会话检测请求；多轮会话通过业务传入的同一个 SessionID 关联
// =============================================================================
require __DIR__ . "/vendor/autoload.php";
use Volcengine\LLMShield\Api\LLMShieldApi;
use Volcengine\LLMShield\Model;
function main() {
$myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com"; // 服务端地址，按地域选择
$ak = "YOUR AK"; // 火山引擎 Access Key
$sk = "YOUR SK"; // 火山引擎 Secret Key
$appid = "app-d8l5k1ivi7p3109v****"; // 资产 ID（应用 ID），控制台创建
$region = "cn-beijing"; // 地域，需与服务地址对应
$TIMEOUT = 10; // 超时时间（秒）
$service = "llmshield";
$client = new LLMShieldApi($myUrl, $ak, $sk, $appid, $region, $TIMEOUT, $service);
if ($client === null) {
echo "创建客户端失败\n";
return;
}
$request = new Model\ModerateV2Request();
$request->Scene = $appid;
$message = new Model\MessageV2();
$message->Role = "user";
$message->Content = "我叫陈*，手机号是1378765****，身份证号440301************，想了解一下入职流程和需要准备的材料。";
$message->ContentType = Model\ContentTypeV2::TEXT;
$request->Message = $message;
$systemMsg = new Model\MessageV2();
$systemMsg->Role = "system";
$systemMsg->Content = "你是一名人力资源助手，负责回答求职者关于招聘、面试和入职流程的咨询。";
$systemMsg->ContentType = Model\ContentTypeV2::TEXT;
$userMsg = new Model\MessageV2();
$userMsg->Role = "user";
$userMsg->Content = "你好，我已经通过了面试，想了解一下入职相关的事宜。";
$userMsg->ContentType = Model\ContentTypeV2::TEXT;
$assistantMsg = new Model\MessageV2();
$assistantMsg->Role = "assistant";
$assistantMsg->Content = "恭喜你通过面试！请问你想了解入职流程、材料准备还是薪资福利方面的信息呢？";
$assistantMsg->ContentType = Model\ContentTypeV2::TEXT;
$request->History = [$systemMsg, $userMsg, $assistantMsg];
// 扩展字段：RunID 标识本次检测请求，SessionID 用于关联同一会话下的多轮检测
$request->Extensions = [
"run_id" => "PHP_RUN_ID_001",
"session_id" => "PHP367898765456721FEAE****",
];
try {
$promise = $client->Moderate($request);
$resp = $promise->wait();
echo "审核结果:\n";
if ($resp === null || $resp[0] === null) {
echo " 空响应\n";
return;
}
echo json_encode($resp[0], JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) . "\n";
echo "Status Code: {$resp[1]}\n";
} catch (Exception $e) {
echo "请求异常: {$e->getMessage()}\n";
}
}
main();
最近更新时间：2026.07.21 21:12:51
这个页面对您有帮助吗？
有用
有用
无用
无用