> ## Documentation Index
> Fetch the complete documentation index at: https://javaai.pig4cloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mistral AI 内容审核

Spring AI 中的 Mistral AI 内容审核功能使用 Mistral AI 的审核模型提供内容审核能力。

## 概述

Mistral AI 内容审核能够：

* 高级内容过滤
* 多语言支持
* 自定义审核规则
* 实时内容分析

## 功能

<CardGroup cols={2}>
  <Card title="内容分析" icon="magnifying-glass">
    深度内容分析
  </Card>

  <Card title="多语言" icon="language">
    支持多种语言
  </Card>

  <Card title="自定义规则" icon="gear">
    可自定义审核规则
  </Card>

  <Card title="实时" icon="clock">
    实时内容审核
  </Card>
</CardGroup>

## 实现

### 基本设置

```xml theme={"system"}
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-mistral-moderation</artifactId>
    <version>${spring-ai.version}</version>
</dependency>
```

### 配置

```properties theme={"system"}
# Mistral AI 内容审核配置
spring.ai.mistral.moderation.enabled=true
spring.ai.mistral.moderation.api-key=${MISTRAL_API_KEY}
spring.ai.mistral.moderation.model=mistral-moderation
```

### 用法

```java theme={"system"}
@Service
public class MistralModerationService {
    private final MistralModerationClient moderationClient;

    public MistralModerationService(MistralModerationClient moderationClient) {
        this.moderationClient = moderationClient;
    }

    public ModerationResult moderateContent(String content) {
        return moderationClient.moderate(content);
    }
}
```

## 审核功能

### 1. 基本审核

```java theme={"system"}
@Configuration
public class MistralModerationConfig {
    @Bean
    public ModerationClient mistralModerationClient(MistralModerationProperties properties) {
        return new MistralModerationClient(properties);
    }
}
```

### 2. 特定语言审核

```java theme={"system"}
@Configuration
public class LanguageModerationConfig {
    @Bean
    public ModerationClient languageModerationClient(MistralModerationProperties properties) {
        return ModerationClient.builder()
            .properties(properties)
            .languages(Arrays.asList("en", "fr", "es"))
            .build();
    }
}
```

### 3. 自定义审核规则

```java theme={"system"}
@Configuration
public class CustomModerationConfig {
    @Bean
    public ModerationClient customModerationClient(MistralModerationProperties properties) {
        return ModerationClient.builder()
            .properties(properties)
            .rules(customRules())
            .build();
    }

    private List<ModerationRule> customRules() {
        return Arrays.asList(
            new ModerationRule("hate", 0.7),
            new ModerationRule("harassment", 0.6),
            new ModerationRule("violence", 0.8)
        );
    }
}
```

## 高级功能

### 自定义审核逻辑

```java theme={"system"}
@Component
public class CustomModerationLogic implements ModerationLogic {
    @Override
    public ModerationResult process(String content) {
        // 自定义审核逻辑
        return result;
    }

    @Override
    public boolean isAllowed(ModerationResult result) {
        // 自定义允许逻辑
        return allowed;
    }
}
```

### 审核监控

```properties theme={"system"}
management.endpoints.web.exposure.include=mistral-moderation
management.endpoint.mistral-moderation.enabled=true
```

## 最佳实践

<Note>
  使用 Mistral AI 内容审核时，请考虑以下最佳实践：
</Note>

* **API 安全**：保护您的 API 密钥
* **错误处理**：实现稳健的错误处理
* **速率限制**：监控 API 使用情况
* **语言支持**：配置适当的语言
* **规则管理**：维护清晰的审核规则

## 故障排除

常见问题和解决方案：

1. **API 问题**
   * 验证 API 密钥
   * 检查 API 限制
   * 查看错误消息

2. **语言问题**
   * 验证语言支持
   * 检查语言检测
   * 查看语言设置

3. **性能问题**
   * 优化请求频率
   * 实现缓存
   * 使用批处理

<Card title="文档有误？请协助编辑" icon="pencil" href="https://github.com/javaai-pig4cloud-com/javaai-docs/edit/main/spring-ai/api/moderation/mistral-ai-moderation.mdx">
  发现文档问题？点击此处直接在 GitHub 上编辑并提交 PR，帮助我们改进文档！
</Card>