SDK接入与卸载

from aiguard import AiGuardClient, ClientConfig

# 1. 创建客户端
config = ClientConfig(
    base_url="YOUR_BASE_URL",        # 必填：护栏服务端地址，如 https://aiguard.huaweicloudwaf.cn
    project_id="YOUR_PROJECT_ID",    # 必填：项目ID
    app_id="YOUR_APP_ID",            # 必填：AI应用ID
    verify_ssl=False,                # 当前版本默认不验证服务端证书
)

with AiGuardClient(
    ak="YOUR_AK",                   # 必填：Access Key
    sk="YOUR_SK",                   # 必填：Secret Key
    config=config,
) as client:
    # 2. 文本检测
    result = client.text_detect("今天天气怎么样？")
    print(f"结果: {result.suggestion}")  # pass 或 block

    # 3. 图像检测（支持 raw base64 或 data:image/xxx;base64,... 格式）
    import base64
    with open("image.png", "rb") as f:
        image_data = base64.b64encode(f.read()).decode()
    img_result = client.image_detect(image_data)
    print(f"结果: {img_result.suggestion}")

#!/usr/bin/env python
import base64
from aiguard import AiGuardClient, ClientConfig, TextDetectOptions, Message

config = ClientConfig(
    base_url="https://aiguard.huaweicloudwaf.cn",  # 必填：护栏服务端地址
    project_id="YOUR_PROJECT_ID",            # 必填：项目ID
    app_id="YOUR_APP_ID",                    # 必填：AI应用ID
    verify_ssl=False,         # 当前版本默认不验证服务端证书
    connect_timeout=10,       # 连接超时（秒），默认5
    read_timeout=30,          # 读取超时（秒），默认5
    max_retries=5,            # 最大重试次数，默认3
    initial_delay=2,          # 重试初始延迟（秒），默认1
    max_delay=60,             # 重试最大延迟（秒），默认60
    log_level="DEBUG",        # 日志级别，可选 DEBUG/INFO/ERROR，默认 INFO
    # proxy="http://127.0.0.1:8888",  # 可选：HTTP代理地址（详见1.10节）
)

with AiGuardClient(
    ak="YOUR_AK",                   # 必填：Access Key
    sk="YOUR_SK",                   # 必填：Secret Key
    config=config,
) as client:
    # 1. 带对话历史的文本检测
    history = [
        Message(role="user", content="你好"),
        Message(role="assistant", content="你好，有什么可以帮助你的？"),
    ]
    options = TextDetectOptions(
        role="user",
        history=history,
        end_user="tenant_123",
        source_region="cn-north-4",
        app_id="YOUR_APP_ID",        # 可选：单次请求覆盖 app_id
    )
    result = client.text_detect("谢谢", options=options)
    print(f"文本结果(带历史): {result.suggestion}")

    # 2. 图像检测
    image_path = "/path/to/image.bmp"
    with open(image_path, "rb") as f:
        image_data = base64.b64encode(f.read()).decode()
    img_result = client.image_detect(image_data)
    print(f"图像结果: {img_result.suggestion}")

    # 3. 单次请求覆盖 project_id/app_id
    options_override = TextDetectOptions(project_id="YOUR_PROJECT_ID")
    result2 = client.text_detect("测试覆盖", options=options_override)
    print(f"文本结果(覆盖project_id): {result2.suggestion}")

import com.huawei.aiguard.client.AiGuardClient;
import com.huawei.aiguard.config.ClientConfig;
import com.huawei.aiguard.model.DetectResult;

// 1. 创建客户端（try-with-resources 自动释放）
ClientConfig config = ClientConfig.builder()
    .baseUrl("YOUR_BASE_URL")         // 必填：护栏服务端地址，如 https://aiguard.huaweicloudwaf.cn
    .projectId("YOUR_PROJECT_ID")
    .appId("YOUR_APP_ID")
    .verifySsl(false)                 // 当前版本默认不验证服务端证书
    .build();

try (AiGuardClient client = new AiGuardClient("YOUR_AK", "YOUR_SK", config)) {
    // 2. 文本检测
    DetectResult result = client.textDetect("今天天气怎么样？", null);
    System.out.println("结果: " + result.getSuggestion()); // pass 或 block

    // 3. 图像检测
    String imageData = "data:image/png;base64,iVBORw0KGgo...";
    DetectResult imgResult = client.imageDetect(imageData, null);
    System.out.println("结果: " + imgResult.getSuggestion());
}
// 4. try-with-resources 自动调用 close()

import com.huawei.aiguard.client.AiGuardClient;
import com.huawei.aiguard.config.ClientConfig;
import com.huawei.aiguard.model.DetectResult;
import com.huawei.aiguard.model.Message;
import com.huawei.aiguard.model.TextDetectOptions;

ClientConfig config = ClientConfig.builder()
    .baseUrl("https://aiguard.huaweicloudwaf.cn")  // 必填：护栏服务端地址
    .projectId("YOUR_PROJECT_ID")
    .appId("YOUR_APP_ID")
    .verifySsl(false)          // 当前版本默认不验证服务端证书
    // .sslCertPath("/path/to/ca.pem")  // 后续版本支持
    .connectTimeout(10)
    .readTimeout(30)
    .maxRetries(5)
    .initialDelay(2)
    .maxDelay(60)
    .logLevel("DEBUG")          // 日志级别，可选 DEBUG/INFO/ERROR，默认 INFO
    // .proxy("http://127.0.0.1:8888")  // 可选：HTTP代理地址（详见2.10节）
    .build();

try (AiGuardClient client = new AiGuardClient("ak", "sk", config)) {
    // 带对话历史的文本检测
    Message history1 = new Message("user", "你好");
    Message history2 = new Message("assistant", "你好，有什么可以帮助你的？");

    TextDetectOptions options = TextDetectOptions.builder()
        .role("user")
        .history(Arrays.asList(history1, history2))
        .endUser("tenant_project_id")
        .sourceRegion("cn-north-4")
        .appId("YOUR_APP_ID")          // 可选：单次请求覆盖 appId
        .build();

    DetectResult result = client.textDetect("谢谢", options);
}

<!-- SLF4J 实现：logback -->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.4.11</version>
</dependency>

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} - %logger{36} - %level - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 文件输出 -->
    <appender name="FILE" class="ch.qos.logback.core.FileAppender">
        <file>/path/to/sdk.log</file>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} - %logger{36} - %level - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- SDK 日志级别 -->
    <logger name="com.huawei.aiguard" level="DEBUG" />

    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
    </root>
</configuration>

<!-- SLF4J 实现：slf4j-simple（仅用于测试） -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-simple</artifactId>
    <version>2.0.13</version>
    <scope>test</scope>
</dependency>

# 日志输出到控制台（DEBUG级别）
java "-Dorg.slf4j.simpleLogger.defaultLogLevel=DEBUG" \
     -cp "your-app.jar:aiguard-sdk-0.1.0-with-dependencies.jar:slf4j-simple-2.0.13.jar" \
     com.example.YourMain

# 日志输出到文件
java "-Dorg.slf4j.simpleLogger.defaultLogLevel=DEBUG" \
     "-Dorg.slf4j.simpleLogger.logFile=/path/to/sdk.log" \
     -cp "your-app.jar:aiguard-sdk-0.1.0-with-dependencies.jar:slf4j-simple-2.0.13.jar" \
     com.example.YourMain