SuperAPI AI 工具集

docyrus-architect

智能体与模型

查看项目

更新于 10-16 05:06

技能介绍

用途:Docyrus Architect 提供一组 MCP 工具,用于在 Docyrus 平台管理数据源(表)、字段、枚举、应用、自定义查询,并查询数据。

主要能力:发现类工具包括 get_apps、get_data_source_list、get_data_source_list_with_fields、get_data_source_metadata、get_enums_by_field_id、read_current_user、read_tenant_user。数据源 CRUD 包括 create_data_source、create_data_sources_batch(单事务最多 20 个,支持用 slug 交叉引用关系)、update_data_source、delete_data_source。字段管理包括 create_fields、update_fields、delete_fields。枚举管理包括 create_enums、update_enums、delete_enums。查询与计算包括 query_data_source、evaluate_jsonata。自定义查询包括 get_custom_queries、get_custom_query_by_id、create_custom_query、update_custom_query、delete_custom_query、run_custom_query。另有 regenerate_openapi_spec 用于在结构变更后重新生成并上传租户 OpenAPI 规范。

使用方式:创建数据源时先 get_apps 找目标应用,再 create_data_source(title 复数、name 单数、slug 单数 snake_case),随后 create_fields,对 select/tagSelect/status 字段调用 create_enums,最后 regenerate_openapi_spec。批量创建推荐 create_data_sources_batch,字段可内联 enumOptions,关系字段用同批数据源 slug 引用。查询前先 get_data_source_metadata 获取字段 slug 与关系,再调用 query_data_source;columns 为逗号分隔字符串,聚合计数用 id 字段。自定义查询使用 Handlebars SQL 模板,支持 TENANT_ID 等上下文变量与 {{filter FILTERS.<slug> <column_expression>}},运行前可用 simulate: true 查看执行计划。

限制:run_custom_query 单次最多 50,000 行,普通执行 15 秒超时,simulate 模式 30 秒超时;delete_custom_query 为软删除归档;字段与枚举 slug 须匹配 ^[a-z][a-z0-9_]*$;批量操作失败会整体回滚。其余收费、平台支持范围等资料暂未提供。