在 tio-boot 应用中整合 ai-agent

本文档将介绍如何在其他 tio-boot 应用中集成 ai-agent 组件，以便复用其强大的 AI 聊天及对话能力。以下内容包含 Maven 依赖的添加、路由配置以及接口调用示例。

1. 添加 Maven 依赖

在项目的 pom.xml 文件中添加如下依赖，从 Maven 仓库中引入 ai-agent 组件：

<dependency>
  <groupId>com.litongjava</groupId>
  <artifactId>ai-agent</artifactId>
  <version>1.0.0</version>
</dependency>

通过添加该依赖，您的项目即可获得 ai-agent 中提供的全部功能，方便后续调用相关 API 进行对话管理、会话创建、历史记录查询等操作。

2. 添加 HTTP 路由

集成 ai-agent 后，需要配置 HTTP 请求路由，将前端的请求映射到相应的业务处理方法上。下面的代码示例展示了如何通过 tio-boot 框架添加路由，调用 ai-agent 中的 ApiChatHandler 类的方法：

import com.litongjava.llm.handler.ApiChatHandler;

// 获取 HTTP 请求路由器
HttpRequestRouter r = TioBootServer.me().getRequestRouter();
if (r != null) {
  ApiChatHandler apiChatHandler = Aop.get(ApiChatHandler.class);
  r.add("/api/v1/chat/recommend", apiChatHandler::recommend);
  r.add("/api/v1/chat/create", apiChatHandler::createSession);
  r.add("/api/v1/chat/list", apiChatHandler::listSession);
  r.add("/api/v1/chat/delete", apiChatHandler::deleteSession);
  r.add("/api/v1/chat/set/name", apiChatHandler::setSessionName);
  r.add("/api/v1/chat/like", apiChatHandler::like);
  r.add("/api/v1/chat/history", apiChatHandler::getChatHistory);
  r.add("/api/v1/chat/stop", apiChatHandler::stop);
  r.add("/api/v1/chat/send", apiChatHandler::send);
}

路由说明

推荐接口：/api/v1/chat/recommend
用于获取推荐的聊天话题或对话建议。
创建会话：/api/v1/chat/create
调用该接口可以新建一个聊天会话。
会话列表：/api/v1/chat/list
查询当前用户的所有聊天会话。
删除会话：/api/v1/chat/delete
根据会话 ID 删除指定的聊天会话。
设置会话名称：/api/v1/chat/set/name
可对已存在的会话设置或修改名称。
点赞接口：/api/v1/chat/like
支持对特定回复或对话进行点赞操作。
聊天历史记录：/api/v1/chat/history
查询指定会话的聊天历史记录。
停止会话：/api/v1/chat/stop
可用于主动停止当前进行中的聊天会话。
发送消息：/api/v1/chat/send
该接口用于发送用户消息，并由 ai-agent 进行回复。

3. 前端接口调用说明

完成上述依赖添加和路由配置后，前端即可按照后续文档中的格式要求调用上述接口，创建和管理 AI 应用。前端开发人员应确保：

请求 URL 与上述路由匹配。
请求参数满足各个接口的格式要求，例如必要字段不能为空。
调用过程中关注响应状态和返回的数据格式，以便进行后续业务处理。

4. 总结

通过以上步骤，您可以在 tio-boot 应用中成功整合 ai-agent 模块，并利用其提供的丰富 API 实现 AI 聊天、会话管理及历史记录查询等功能。集成完成后，前端可以直接调用接口，构建具有智能对话能力的应用场景。

以上即为在其他 tio-boot 应用中整合 ai-agent 的完整操作指南。