用途：为 Docyrus 系统基础助手（Docy）构建应用级自定义工具，让 Docy 在对话中调用。工具按应用（tenant_ai_tool，ownership=CUSTOM，tenant_app_id=<app>）创建；应用安装到租户后，其工具自动对基础助手可用，无需按智能体接线。
主要能力与四种工具类型：data_source_query 用于从单一数据源读取/列出记录，LLM 只提供过滤值，服务端执行并受 RLS 约束；custom_query 用于需要手写只读 SELECT SQL 的跨表连接/聚合查询，服务端只读事务并受 RLS；secure_exec 用于多步逻辑、调用 Docyrus REST API（含写入）、转换/压缩结果，运行在服务端沙箱（10 秒、无文件系统/环境变量、仅 Docyrus API 网络）；client_side 用于必须在用户浏览器/应用中执行的动作（UI 导航、本地选择、宿主 API），仅定义输入/输出 schema，由宿主应用实现处理程序。
使用方式：所有命令需已认证的 CLI 会话（docyrus auth who 验证），每条命令用 --appId 或 --appSlug 之一选择应用。命令包括 list、get、create、update、delete，路由到 /v1/dev/apps/:appId/ai-tools。常用标志：--name、--key（LLM 看到的函数名，snake_case 且全局唯一）、--description、--type、--inputJsonSchema（运行时必需，无参数工具也需 {"type":"object","properties":{}}）、--outputJsonSchema、--icon、--environments、--needsApproval、--dynamicApprovalFormula；类型专属标志见各类型参考文件。可用 --from-file 或 --data 传原始 JSON（snake_case），便利标志会合并覆盖。设置应用级引导：docyrus apps set-agent-context --appSlug <slug> --from-file agent-context.md，或 --value，或 --clear，三者只能选一。
适用场景：需要让 Docy 读取应用数据、执行只读 SQL、运行多步 API 逻辑或触发前端动作时。
限制：应用级工具专属系统基础助手 Docy，不能附加到自定义 AI 智能体；应用未安装到租户时其工具不会加载。端点强制 ownership=CUSTOM 与 tenant_app_id，平台管理字段不可设置。省略 --type 会默认 system，不会注册为上述类型。变更数据的工具建议 --needsApproval true。创建后可用 docyrus apps ai-tools get --toolId <id> 验证，并通过与基础助手对话测试。