<mark>此插件，主要社区贡献人（小奶奶花生米）</mark>

```xml
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-ai-repo-redis</artifactId>
</dependency>
```


### 1、描述

solon-ai 的主展插件，基于 RediSearch 适配的  RedisRepository 知识库。更多可参考 [《教程 / Solon AI 开发》](/article/learn-solon-ai)


### 2、环境准备

使用 RedisRepository 时，需要嵌入模型做为支持，同时要添加用于查询的索引声明。还需要使用专门的 RediSearch 服务，或者在 Redis 服务上，添加 RediSearch 能力扩展。附 docker-compose 配置参考（方便测试）：

```yaml
version: '3'

services:
  redis:
    image: redis/redis-stack-server:latest
    container_name: redisearch
    ports:
      - 16379:6379 #测试时，避免与 redis 端口冲突
```

### 3、构建示例

使用 RedisRepository 时，需要嵌入模型做为支持。

```yaml
solon.ai.embed:
  bgem3:
    apiUrl: "http://127.0.0.1:11434/api/embed" # 使用完整地址（而不是 api_base）
    provider: "ollama" # 使用 ollama 服务时，需要配置 provider
    model: "bge-m3:latest"
    
solon.ai.repo:
  redis:
    server: "127.0.0.1:16379"  # 改为你的 Redis  地址
    db: 0
    maxTotal: 200
```

开始构建

```java
@Configuration
public class DemoConfig {
    //构建向量模型
    @Bean
    public EmbeddingModel embeddingModel(@Inject("${solon.ai.embed.bgem3}") EmbeddingConfig config) {
        return EmbeddingModel.of(config).build();
    }
    
    //构建知识库的连接客户端
    @Bean
    public RedisClient client(@Inject("${solon.ai.repo.redis}") RedisClient client){
        return client；
    }
    
    //构建知识库
    @Bean
    public RedisRepository repository(EmbeddingModel embeddingModel, RedisClient client){
        // 创建元数据索引字段列表
        List<MetadataField> metadataFields = new ArrayList<>();
        metadataFields.add(MetadataField.tag("title")); 
        metadataFields.add(MetadataField.tag("category"));
        metadataFields.add(MetadataField.numeric("price"));
        metadataFields.add(MetadataField.numeric("stock"));
        
        return RedisRepository.builder(embeddingModel, client.jedis())
                         .metadataIndexFields(metadataFields)
                         .build();
    }
}
```

### 4、应用效果

```java
@Component
public class DemoService {
    //可使用统一的 RepositoryStorable 接口注入
    @Inject
    RepositoryStorable repository;
    
    //添加资源
    public void addDocument(List<Document> docs) {
        repository.insert(docs);
    }
    
    //查找资料
    public List<Document> findDocument(String query) {
       //参考 solon-expression 语法。例如：price > 12 AND category == 'book'
       return repository.search(query);
    }
}
```