用途:使用 docyrus agent CLI 及其子资源,端到端设计、构建、校验并测试自定义 Docyrus AI 智能体。智能体是 tenant_ai_agent 中的一行(身份+模型+能力配置),外加一组子资源(工具、数据源、文档、MCP、连接、动态上下文、工作流步骤、部署)。
主要能力与流程:先确认应用与认证(docyrus auth who --json、docyrus apps list --json),智能体按开发应用范围隔离。设计智能体形态(对话助手、可调用技能或工作流智能体)、指令、默认/备用模型及所需能力。创建时唯一必填字段为 --skillName,其余有服务端默认值(mode→conversation、ownership→CUSTOM、status→1、is_agent→true、memory_token_limit→4000)。能力开关(--supportTools、--supportDataSources、--supportFiles、--supportKnowledgeBase、--supportWebSearch)需先开启,再挂载对应子资源。子资源按顺序挂载:data-sources、tools、docs、mcps、connections、dynamic-contexts、workflow-steps(仅当 --hasWorkflow)、deployments。
用法要点:子资源组支持 list/get/create/update/delete,需传 app 与 --agentId,行 id 用通用 --id。工具是两步流程:先用 docyrus apps ai-tools 定义工具,再用 docyrus agent tools create --coreAiToolId <id> 挂载。模型/数据源/工具 id 是真实外键,需先解析,不能编造。--ownership 有效值为 APP | CUSTOM | PRODUCT | SYSTEM | USER(默认 CUSTOM),帮助文本有误。
限制:已知后端问题,agent create 当前因 name 为生成列而失败,需改用其他路径创建的智能体操作。agent tasks 与 recurring-tasks 对当前后端不可用(404),应改用自动化 recurrence 触发器。子资源创建需在 RLS 下可见且拥有该智能体,否则返回 404。每次操作后应校验并测试,删除临时智能体。