double[] 转 float[]（Milvus SDK 需要 float[]）

将业务文本转换为 AgentScope Msg @param userId 用户 ID @param sessionId 会话 ID @param role 角色 @param content 内容 @param modelName 模型名称 @return Msg 对象 @author Tell

返回 401 未授权

更新配置值

修改部门（超级管理员和普通管理员） @param request 修改请求 @return 部门信息

更新用户 Memory 画像 @param profile 画像对象 @return Markdown 内容 @author TellyJiang @since 2026-04-11

追加用户消息到 memory 会话工作区 @param session 当前会话 @param modelConfig 模型配置 @param userMsg 用户消息 @author TellyJiang @since 2026-04-18

校验画像更新请求权限 @param profile 画像对象 @author TellyJiang @since 2026-04-11

评估工具风险等级

设置角色的数据范围 <p>仅当角色的dataScope为5（自定义部门）时才允许设置，会校验每个部门ID是否存在。</p> @param request 设置数据范围请求体（包含角色ID和部门ID列表） @return 设置结果

为角色分配权限 <p>校验角色和权限是否存在，以及是否已存在相同的关联关系。</p> @param request 分配权限请求体（包含角色ID和权限ID） @return 分配结果

首轮对话自动生成会话标题（截取助手回复前 30 个字符）

查询当前用户可用的模型列表

构建 Anthropic 原生协议模型

根据 dataScope 类型构建 SQL 过滤条件 @param context 数据权限上下文 @param deptAlias 部门列别名 @param userAlias 用户列别名 @return SQL 条件片段，如 "dept_id IN (1,2,3)" 或 "create_b

组装上下文消息列表（摘要 + 历史消息） <p> 注意：系统提示词由 ReActAgent 内部注入，此处不再重复添加。 </p>

构建完整的系统提示词（基础 sysPrompt + 长期记忆 + 用户画像） <p> 该提示词传给 ReActAgent，由 Agent 内部作为 SYSTEM 消息注入，避免与 messages 中的内容重复。 </p>

根据 MCP 配置构建 McpClientWrapper @param mcp MCP 配置实体 @return MCP 客户端

构建 OpenAI 兼容模型（适用于绝大多数 provider）

构建画像摘要 @param profile 用户画像 @return 摘要文本 @author TellyJiang @since 2026-04-14

将 Skill 作为 MCP 客户端注册（Skill 底层也走 MCP 协议） @param skill Skill 配置实体 @return MCP 客户端，如果 Skill 类型不支持则返回 null

递归构建树形结构 @param allDepts 所有部门列表 @param parentId 父部门 ID @return 树形结构

缓存窗口外旧消息到 Redis（压缩摘要后调用，供下次压缩时直接取） <p> 存储格式：JSON 数组，每个元素包含 role 和 content。 </p> @param userId 用户 ID @param sessionId 会话 ID @param messages 窗口外的旧消

参数校验 <p>在业务处理之前执行，用于校验请求参数的合法性、业务规则等。 校验不通过时应抛出 {@link org.evolve.common.web.exception.BusinessException}。</p> @param request 请求参数

手动触发单实例心跳检测

清除当前线程的数据权限上下文（必须在请求结束时调用）

同步检查并压缩 <p> 优先从 Redis detail 字段取旧消息，miss 则回查 DB。 压缩完成后同时写入 Redis（summary + detail）和 SQL。 </p>

异步检查并压缩上下文摘要 <p> 如果会话消息数 > WINDOW_SIZE，触发摘要生成/更新。 </p> @param session 会话实体 @param modelConfig 模型配置（用于调用 LLM 生成摘要）

将 GitHub tree URL 转换为 archive zip URL 例如: https://github.com/owner/repo/tree/branch/path 转换为: https://github.com/owner/repo/archive/refs/heads/branch.

反序列化列表 @param json JSON 内容 @param clazz 元素类型 @param <T> 泛型类型 @return 列表结果 @author TellyJiang @since 2026-04-12

统计指定用户的会话数量

为用户创建 API Key @param userId 用户 ID @return 创建的 API Key 实体

创建授权记录 @param entity 授权实体

创建 HTTP 客户端 根据 protocol 字段选择传输协议： - "SSE" 或空（兼容旧数据）→ HttpClientSseClientTransport（旧版 SSE，连接 /sse） - "STREAMABLE_HTTP" → HttpClientStreamableHttpTrans

创建短期记忆实例 @return 短期记忆 @author TellyJiang @since 2026-04-14

创建 STDIO 客户端 UPLOADED 模式流程：从 S3 下载 ZIP → 解压到本地 → shell 包装器设置工作目录 → 启动进程 STDIO 模式流程：直接使用配置的命令启动进程

删除部门（仅超级管理员） @param id 部门 ID @return 空

禁用用户的 API Key @param userId 用户 ID

手动触发工具发现

异步执行流式对话（在虚拟线程中运行） <p> 核心流程：构建 Agent → agent.stream() → Event 映射 SSE → 后处理（保存消息/统计/记忆）。 Event 类型映射： <ul> <li>REASONING → type=reasoning（推理过程/文本片段）</

对文本进行向量化 @param content 文本内容 @return 向量结果 @author TellyJiang @since 2026-04-11

将文本向量化 @param text 待向量化的文本 @return 向量数组

确保依赖已安装（复用目录时调用） 检查 node_modules/.package-lock.json 是否存在， 如果不存在说明依赖安装不完整或从未执行过