Instalação - AI Guardrails: Central de Documentação do Alibaba Cloud

Instale o SDK do AI Guardrails para Java adicionando as dependências Maven ao seu projeto. Este guia usa a versão 3.6.6 do aliyun-java-sdk-green como exemplo.

Pré-requisitos

Antes de começar, verifique se você tem:

Java 1.6 ou superior. Execute java -version para verificar a versão.
Apache Maven. Necessário para gerencie dependências.

Adicionar dependências Maven

Adicione as seguintes dependências à seção <dependencies> do arquivo pom.xml:

<!-- Core SDK -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.1.1</version>
</dependency>

<!-- AI Guardrails (Content Moderation) -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-green</artifactId>
    <version>3.6.6</version>
</dependency>

<!-- JSON serialization -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.9</version>
</dependency>

<!-- OSS SDK: required for uploading local or binary files before moderation -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>2.8.3</version>
</dependency>

Dependências opcionais

Se o código precisar ler arquivos ou converter strings, adicione:

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.4</version>
</dependency>
<dependency>
    <groupId>commons-codec</groupId>
    <artifactId>commons-codec</artifactId>
    <version>1.10</version>
</dependency>

Envie arquivos locais ou binários

Para enviar um arquivo local ou binário para moderação de conteúdo, baixe e importe a classe utilitária Extension.Uploader no seu projeto.

Configure variáveis de ambiente

O SDK lê o par de AccessKey das variáveis de ambiente em tempo de execução. Ao chamar operações da API, o sistema autentica automaticamente com essas credenciais. Antes de usar o código de exemplo do SDK, defina ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET.

Linux / macOS

export ALIBABA_CLOUD_ACCESS_KEY_ID=<your-access-key-id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<your-access-key-secret>

Windows (Prompt de Comando)

setx ALIBABA_CLOUD_ACCESS_KEY_ID "<your-access-key-id>"
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET "<your-access-key-secret>"

Após executar setx no Windows, reinicie as sessões de terminal abertas para que as variáveis entrem em vigor.

Substitua <your-access-key-id> e <your-access-key-secret> pelo seu par de AccessKey da Alibaba Cloud. Para obter instruções sobre como criar um par de AccessKey, consulte Configurar credenciais.