用途:这是 Taruvi 后端的控制平面技能,用于通过 Taruvi MCP 服务器开通和修改后端资源。写部署函数内的 Python 应改用 taruvi-functions,构建 Refine 前端应改用 taruvi-refine-frontend。
主要能力:工具按域分为数据表(get_datatable_schema、create_update_schema、datatable_data、datatable_edges、delete_datatable)、存储(manage_storage)、密钥(list_secrets、get_secret、create_update_secret、manage_secret_types)、用户(list_users、create_user、update_user)、用户属性(user_attributes_schema)、角色(manage_roles、manage_role_assignments)、函数(manage_function、execute_function)、策略(manage_policies)、分析(manage_query、execute_query)、原始 SQL(execute_raw_sql)与元信息(manage_tags、get_ai_docs),共 24 个工具。
必要用法:数据表用 Frictionless Data Package 定义并经 create_update_schema 物化为 PostgreSQL 表;行操作用 datatable_data 的 query/upsert/delete,过滤遵循 DRF 约定(如 field__gte)。创建用户前先 manage_roles(action="list") 并自动选择角色;角色分配支持 assign/revoke。策略 create_update 为整体替换而非合并;密钥需先有匹配的密钥类型。原始 SQL 拒绝跨租户访问与视图/触发器等 DDL,DDL 会立即提交。
限制:Frictionless schema 是 upsert 而非合并,缺失字段会被删除;manage_policies 与 user_attributes_schema 更新均为全量替换;delete_datatable 默认受外键约束限制,force=True 危险;密钥类型的 sensitivity_level 创建后不可改,系统类型不可修改;用户更新不接受密码修改;list_users 默认隐藏非活跃用户;manage_function 的 get 只返回活跃函数。破坏性操作须先计划、验证并向用户确认后再执行。