用途：说明 Multica 智能体创建路径的契约，讲清创建入口接受什么、服务端校验与拒绝什么、各字段如何持久化，以及守护进程在任务认领时实际读取哪些字段。
主要能力与概念：智能体是工作区级数据行（表 agent），创建为单次 POST /api/agents。守护进程在认领任务时重新读取该行并组装运行时负载，因此真正生效的是已持久化字段，而非创建时的输出。两个常被混淆的文本字段：description 是目录摘要，仅存储并展示，不注入运行时提示，上限 255 个 Unicode 码点；instructions 是运行时行为契约，守护进程在认领时读取并作为持久指令发送给提供方，人设、职责、边界、输出与升级规则应写在此处。
使用方式：最小创建调用中 --name 与 --runtime-id 均为必填：multica agent create --name <name> --runtime-id <runtime-id> --description "<short catalog summary>" --instructions "<runtime behavior contract>" --output json。只读检查命令包括 multica agent get <agent-id> --output json、multica agent skills list <agent-id> --output json、multica agent env get <agent-id> --output json。复制智能体使用 multica agent copy <source-agent-id>，可加 --name、--runtime-id、--model、--no-skills 等。
限制与注意：--max-concurrent-tasks 需在 1–50 之间，CLI 发送前校验；custom_env 属机密材料，读写不经过 agent update，须用专用端点与 --custom-env-stdin 或 --custom-env-file（0600）；mcp_config 可经 agent update 设置，读取时按权限脱敏。未提供的信息本资料未涉及。