大模型

ragflow4j 开发记录 - 2025-03-28

ragflow 4j是一个开源的RAG引擎。与Dify、Ragflow等不同,它用Java开发。市场上的类似产品大多是用Python开发的。我希望通过这个项目,能够帮助那些使用Java作为主要开发语言的开发人员更好地理解RAG的整体机制。

ragflow4j 开发记录 - 2025-03-28

大家好,我是Aaron。当前在实践”辅助AI编程”,目前有个比较火的词语是”干中学”。因此,我希望能通过一步步完善项目,来掌握RAG相关知识。因此正在开发一个名为ragflow4j(https://github.com/aaronshan/ragflow4j) 的项目。为了方便记录,我会在每天结束时让AI总结今天的开发进展,同步到公众号。

欢迎大家关注我的公众号,第一时间收到更新推送,一步一步一起开发RAG引擎。

项目简介 📖

ragflow4j(https://github.com/aaronshan/ragflow4j) 是一个开源的 RAG(检索增强生成)引擎。与 Dify、Ragflow 等不同,它是用 Java 开发的。市面上类似的产品大多使用 Python 开发。我希望通过这个项目能帮助以 Java 为主要开发语言的开发者更好地理解 RAG 的整体机制。

今日工作内容 ✨

今天主要完成了 Application Management Service 的设计和实现,这是 RAGFlow4J 的核心功能之一。具体完成了以下工作:

  1. 1. 应用管理接口设计
  • 设计了应用管理的核心接口

  • 实现了应用的基本 CRUD 操作

  • 添加了应用配置管理功能

public interface ApplicationService {
    Application createApplication(ApplicationDTO dto, Long userId);
    Application updateApplication(Long id, ApplicationDTO dto, Long userId);
    Application getApplication(Long id);
    void deleteApplication(Long id);
    Set<Knowledge> getKnowledges(Long applicationId);
    Set<Skill> getSkills(Long applicationId);
    Set<Workflow> getWorkflows(Long applicationId);
}
  1. 2. 应用类型实现
  • 通用型对话应用

  • 支持自定义 prompt

  • 可灵活关联知识库、技能和工作流

  • 配置灵活度高

  • FAQ型对话应用

  • 专门用于关联 FAQ 型知识

  • 适用于固定、可控性要求高的场景

  • 优化了问答匹配逻辑

  • 工作流型对话应用

  • 100%触发关联的唯一工作流

  • 适用于需要精确执行工作流的场景

  • 实现了工作流执行控制

public enum ApplicationType {
    GENERAL_CHAT,    // 通用型对话应用
    FAQ_CHAT,        // FAQ型对话应用
    WORKFLOW_CHAT    // 工作流型对话应用
}

@Entity
@Table(name = "applications")
public class Application {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Enumerated(EnumType.STRING)
    private ApplicationType type;

    private String name;
    private String description;
    private String prompt;
    private Boolean enableVoiceOutput;
    private Boolean enabled;

    @ManyToMany
    @JoinTable(
        name = "application_knowledge",
        joinColumns = @JoinColumn(name = "application_id"),
        inverseJoinColumns = @JoinColumn(name = "knowledge_id")
    )
    private Set<Knowledge> knowledges = new HashSet<>();

    @ManyToMany
    @JoinTable(
        name = "application_skill",
        joinColumns = @JoinColumn(name = "application_id"),
        inverseJoinColumns = @JoinColumn(name = "skill_id")
    )
    private Set<Skill> skills = new HashSet<>();

    @ManyToMany
    @JoinTable(
        name = "application_workflow",
        joinColumns = @JoinColumn(name = "application_id"),
        inverseJoinColumns = @JoinColumn(name = "workflow_id")
    )
    private Set<Workflow> workflows = new HashSet<>();
}
  1. 3. 发布渠道集成
  • 接口接入

  • 网页嵌入

  • 网页链接

  • 企业微信

  • 微信公众号

public enum PublishChannelType {
    API,            // 接口接入
    WEB_EMBED,      // 网页嵌入
    WEB_LINK,       // 网页链接
    WECHAT_WORK,    // 企业微信
    WECHAT_MP       // 微信公众号
}

@Entity
public class Application {
    // ... 其他字段 ...

    @ElementCollection
    @Enumerated(EnumType.STRING)
    private Set<PublishChannelType> publishChannels = new HashSet<>();
}
  1. 4. 应用配置功能
  • 参考来源配置

  • 语音输出配置

  • 会话设置配置

@Service
@Transactional
public class ApplicationServiceImpl implements ApplicationService {
    @Override
    public Application createApplication(ApplicationDTO dto, Long userId) {
        Application application = new Application();
        BeanUtils.copyProperties(dto, application, "id", "createdAt", "createdBy",
            "knowledgeBases", "skills", "workflows", "enableVoiceOutput", "enabled");
        application.setCreatedBy(userId);
        application.setUpdatedBy(userId);

        // 设置 enableVoiceOutput
        if (dto.getEnableVoiceOutput() != null) {
            application.setEnableVoiceOutput(dto.getEnableVoiceOutput());
        }

        // 设置 enabled
        if (dto.getEnabled() != null) {
            application.setEnabled(dto.getEnabled());
        }

        return applicationRepository.save(application);
    }
}

明日开发重点🎯

  1. 1. 完善应用管理功能
  • 实现应用状态管理

  • 添加应用监控功能

  • 完善应用配置界面

  1. 2. 优化应用与知识库、技能、工作流的关联
  • 实现关联关系的动态管理

  • 添加关联验证机制

  • 优化关联性能

  1. 3. 增强应用安全性
  • 实现访问控制

  • 添加操作审计

  • 完善错误处理

温馨提示:欢迎关注公众号【猿悟人生】获取最新开发进展

本文首发于微信公众号。原文:查看原文
微信搜一搜 AI拆解猿