package com.ruoyi.ai.service;

import java.util.List;

/**
 * 知识库RAG服务
 * 负责文件向量化处理和检索
 */
public interface KnowledgeRagService {

    /**
     * 异步处理向量化
     */
    void processVectorAsync(Long vectorId);

    /**
     * 同步处理向量化
     */
    void processVector(Long vectorId);

    /**
     * 检索相关内容
     * @param namespace 命名空间
     * @param query 查询文本
     * @param maxResults 最大结果数
     * @return 相关内容列表
     */
    List<String> searchRelevantContent(String namespace, String query, int maxResults);

    /**
     * 删除指定文件的向量数据
     */
    void deleteEmbeddings(String namespace, Long storageBlobId);
}