# wjxcom/wjx-ai-kit

Source: https://glimind.com/server/github%2Fwjxcom%2Fwjx-ai-kit
Registry id: `github/wjxcom/wjx-ai-kit`
Status: unknown

## Tools (66)

- `add_admin`: 批量添加或修改通讯录管理员（最多100人）。users 为 JSON 数组字符串，每个对象必须包含 userid（管理员用户ID，可在通讯录界面下查看）和 role（角色编码，必填），可选 confidential（是否保密账户）、effective_date（有效期，格式 yyyy-MM-dd）、remark（备注，
- `add_contacts`: 批量添加或更新通讯录联系人（最多100人）。users 为 JSON 数组字符串，每个用户对象须包含 userid、name，可选 mobile、email、department、tags、birthday、gender 等。若 userid 已存在则更新。
- `add_department`: 批量添加部门。depts 为 JSON 数组字符串，每项为部门路径（用/分隔层级，如 "研发部/后端"）。
- `add_participants`: [Deprecated] 向用户系统批量添加参与者（每次最多100人）。users 为 JSON 数组字符串，每个对象包含: uid(参与者唯一编号,必填)、uname(参与者姓名,选填)、upass(初始登录密码,选填)、udept(部门,选填,必须是数组如["部门1"])、uextf(附加信息,选填,必须是数组如[
- `add_sub_account`: 在主账户下创建子账号。可指定角色：1=系统管理员, 2=问卷管理员, 3=统计结果查看员, 4=完整结果查看员。
- `add_tag`: 批量添加通讯录标签。child_names 为 JSON 数组字符串，格式为 "标签组/标签名"，如 ["学历/本科", "学历/硕士"]。
- `bind_activity`: [Deprecated] 将问卷绑定到用户体系，并指定参与者。可设置作答次数限制、是否允许修改答案等。
- `build_preview_url`: 生成问卷预览链接（无需签名），可在浏览器中预览问卷效果。优先传 create_survey_* 返回的 sid；仅在没有 sid 时再传 vid。
- `build_submit_template`: 根据 get_survey 返回的题目结构生成可填充的 submitdata 模板。跳过分页栏/段落说明并保留服务端原始题号；纯本地计算，不调用 API。
- `build_survey_url`: 生成快速创建或编辑问卷的 URL（无需签名）。创建模式生成空白问卷链接，编辑模式生成问卷编辑器链接（需提供 activity 问卷编号）。
- `calculate_csat`: 根据评分数组计算 CSAT（客户满意度），支持 5 分制（1-5，4-5 为满意）和 7 分制（1-7，5-7 为满意）。空数组返回 no-data。输出满意率、满意人数、分值分布。纯本地计算。
- `calculate_nps`: 根据 0-10 整数评分数组计算 NPS（净推荐值），输出推荐者/中立者/贬损者数量与比例，以及评级（>70优秀, 50-70良好, 0-50一般, <0较差）。空数组返回 no-data，不作评级。纯本地计算。
- `clear_recycle_bin`: 清空回收站中的问卷。若指定 vid 则使用彻底删除动作并只处理该问卷，否则调用批量回收站清理。此操作不可逆！
- `clear_responses`: 清空指定问卷的所有答卷数据。此操作不可逆！可选择是否重置答卷序号为0。
- `compare_metrics`: 对比两组指标数据（A/B），输出每个指标的差值、变化率和启发式阈值标记（|变化率|>10%，不是统计显著性检验）。纯本地计算。
- `count_responses`: 获取问卷答卷总数和参与次数。仅请求一条答卷记录，适合 Agent 在不拉取全量数据时快速获取规模指标。
- `create_ai_page`: 调用 OpenAPI A1000107 创建一个独立的纯展示 AI 主页。只调用本工具，不要额外创建或关联表单、问卷。html_content（或兼容字段 html）必填。page_type=2 时必须生成逐页 PPT：每张幻灯片占一个固定画布并逐页切换，禁止把全部内容做成单个纵向长页面。
- `create_survey_by_json`: （推荐，支持 70+ 题型）通过 JSONL 格式创建问卷。每行一个 JSON 对象，首行为 qtype='问卷基础信息' 的元数据。
- `create_survey_from_definition`: 接收 AI 生成的完整 WJX XML DSL，校验通过后调用 A1000109 创建问卷。definition 指 DSL 文本，不是 JSON 问卷模型。
- `decode_push_payload`: 解密问卷星 AES-128-CBC 推送载荷，并可校验 SHA1(rawBody + appKey) 签名。纯本地计算，不调用 API。
- `decode_responses`: 解析问卷星 submitdata 格式（题号$答案}题号$答案），识别单选、多选（管道符分隔）、填空和矩阵题型。纯本地计算，不调用 API。
- `delete_admin`: 批量删除通讯录管理员。uids 为逗号分隔的管理员用户编号列表，一次不能超过100条。
- `delete_contacts`: 从通讯录中批量删除成员。此操作不可逆，请谨慎使用！uids 为逗号分隔的用户编号列表。
- `delete_department`: 批量删除部门。type 指定删除方式：1=按ID删除，2=按名称删除。depts 为 JSON 数组字符串，包含要删除的部门标识列表。
- `delete_participants`: [Deprecated] 从用户系统中批量删除参与者。此操作不可逆，请谨慎使用！uids 为 JSON 数组字符串，如 ["uid1","uid2"]。
- `delete_sub_account`: 删除子账号（可通过 restore_sub_account 恢复）。请谨慎使用。
- `delete_survey`: 删除问卷。普通删除进入回收站（status=3，可恢复）；设置 completely_delete=true 才会彻底删除（status=4，不可恢复）。请谨慎使用。
- `delete_tag`: 批量删除通讯录标签。type 指定删除方式：1=按ID删除，2=按名称删除。tags 为 JSON 数组字符串，包含要删除的标签标识列表。
- `detect_anomalies`: 检测异常答卷：直线作答（所有答案相同）、速度异常（答题时间 < 中位数 30%，至少需要 3 个有效时长样本）、IP+内容重复。样本不足时返回 warning，不启用速度标记。纯本地计算。
- `download_responses`: 批量下载答卷数据，支持 CSV/SAV/Word 格式。超过3000条自动转为异步任务，返回 taskid 用于轮询。
- `generate_wjx_dsl`: 接收 AI 按 wjx-dsl v1 规范生成的 DSL，执行轻量协议校验和规范化；不写入服务器。
- `get_360_report`: 下载360度评估报告的详细数据（XLS格式）。异步模式：首次调用可能返回 status=0 和 taskid，需再次调用并传入 taskid 轮询直到 status=1 获取下载链接。
- `get_config`: 返回 MCP Server 当前使用的 API Base URL、API Key（脱敏）、Corp ID、配置来源等诊断信息。纯本地读取，不调用 API。
- `get_question_tags`: 获取指定用户所在企业的所有题目标签列表。
- `get_report`: 获取问卷的统计报告，包含各题选项频次统计、平均分、总分等聚合数据。注意：valid 参数建议显式传 true 以确保返回完整报告。
- `get_short_link`: 将问卷星问卷长链接转换为短链接，适合短信等场景发送。url 必须是问卷星问卷地址；链接中的查询参数会由接口自动编码。
- `get_survey`: 根据问卷编号获取问卷详情，包括题目和选项信息。AI 主页（atype=12）会直接返回 html_content 和固定的 page_type，草稿无需访问公开页也可读取。
- `get_survey_settings`: 获取问卷的详细设置，包括时间设置、提交后跳转、考试设置、维度、奖品、数据推送等。
- `get_tag_details`: 根据标签 ID 获取标签下的题目详情列表，包括关联的问卷、题目类型和标签名称。
- `get_winners`: 获取问卷的中奖者信息列表，支持按奖品类型和发放状态筛选，支持分页。
- `list_departments`: 查询通讯录中的部门列表。
- `list_surveys`: 分页获取账户下的问卷列表，可按状态、类型、名称筛选。
- `list_tags`: 查询通讯录中的所有标签。
- `modify_department`: 批量修改部门信息（最多100条）。depts 为 JSON 数组字符串，每项为部门对象（包含 id、name、order 等字段）。id 从 list_departments 返回值获取。
- `modify_participants`: [Deprecated] 批量修改用户系统中参与者的信息。users 为 JSON 数组字符串，每个对象包含: uid(参与者唯一编号,必填)、uname(姓名)、upass(密码)、udept(部门,必须是数组格式如["部门1"])、uextf(附加信息,必须是数组格式如["信息1"])。auto_create_ud
- `modify_response`: 修改答卷数据。当前仅支持修改考试问卷的主观题分数（type=1）。answers 为 JSON 字符串，格式 {题号: 分数}。
- `modify_sub_account`: 修改子账号的信息，包括手机号、邮箱、角色、分组等。不支持修改密码。
- `modify_tag`: 修改通讯录标签。可更新标签组名称(tp_name)和子标签(child_names)。tp_id 从 list_tags 返回值获取。
- `query_contacts`: 按用户编号（uid）精确查询通讯录中的指定联系人信息。注意：uid 必须完全匹配，不支持模糊搜索或通配符。corpid 可选，未提供时从 WJX_CORP_ID 环境变量获取。
- `query_responses`: 查询问卷的答卷数据，支持分页、时间范围、条件筛选。返回答卷明细包括提交时间、来源、IP、各题答案等。
- `query_responses_realtime`: 实时查询新提交的答卷（队列模式）。查询成功的答卷将从队列移除，无法二次查询。需联系客服开通白名单。
- `query_sub_accounts`: 查询主账户下的子账号列表，支持按用户名、名称模糊搜索、角色、分组、状态筛选。
- `query_survey_binding`: [Deprecated] 查询问卷与用户系统的绑定关系，返回绑定的参与者列表。支持按参与状态(join_status)、日期(day)、周(week)、月(month)筛选，可选择是否强制获取参与次数(force_join_times)。
- `query_user_surveys`: [Deprecated] 查询指定参与者被分配的问卷列表，支持分页。
- `query_wjx_dsl`: 使用传统编码 vid 查询问卷，返回原有查询内容和 XML DSL 往返结果。
- `restore_admin`: 批量恢复已删除的通讯录管理员。uids 为逗号分隔的管理员用户编号列表，一次不能超过100条。
- `restore_sub_account`: 恢复已删除的子账号。可同时更新手机号和邮箱。
- `sso_partner_url`: 生成合作伙伴/代理商的单点登录（SSO）链接，用于合作伙伴免密登录。
- `sso_subaccount_url`: 生成子账号单点登录（SSO）链接，用于子账号免密登录或自动创建子账号。
- `sso_user_system_url`: 生成用户系统参与者的单点登录（SSO）链接，用于用户系统中的成员免密登录。
- `submit_response`: 向问卷提交答卷数据（代填/导入）。答卷格式：题号$答案}题号$答案，详见问卷星答卷格式规范。
- `update_ai_page`: 调用 OpenAPI A1000108 原位更新 AI 主页。先用 get_survey 读取目标的 html_content 和 page_type，再基于完整原 HTML 做修改；草稿也能读取，不要访问公开页或重做整页。vid 必须是传统数字编号，html_content（或兼容字段 html）必填。页面类型不可修
- `update_survey_from_definition`: 接收传统 vid 和 AI 生成的修改后完整 DSL，校验通过后一次调用 A1000110。后端负责 Diff、Topic 重排、逻辑引用和答卷保护。
- `update_survey_settings`: 修改问卷的设置，包括 API 限制、提交后跳转、数据推送、自定义参数、时间设置等。每个设置项为 JSON 字符串。
- `update_survey_status`: 修改问卷的发布状态：发布(1)、暂停(2)、删除(3，进入回收站，可恢复)。
- `upload_file`: 上传图片文件用于问卷。支持 png/jpg/gif/jpeg/bmp/webp 格式，文件以 Base64 编码传入，最大约 4MB。

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.