docs(agent): simplify createAgent guide and add sub-agent tasks

Author: dingyi222666

docs/.vitepress/config.ts

@@ -523,7 +523,7 @@ function sidebarDevelopment(): DefaultTheme.SidebarItem[] {
                     link: "/development/call-core-services/model-tool",
                 },
                 {
-                    text: "Agent",
+                    text: "Agent 与 Sub-Agent",
                     link: "/development/call-core-services/agent",
                 },
                 {

docs/development/api-reference/chatluna-service.md

@@ -85,6 +85,53 @@ ChatLuna 服务是整个系统的核心，用于管理插件、对话、模型
 
 创建一个嵌入模型的计算引用。若模型不可用会回退为空嵌入实现。
 
+### chatluna.createAgent()
+
+- **options**: `CreateChatLunaAgentOptions`
+- 返回值: `Promise<ChatLunaAgent>`
+
+创建一个高层 Agent 实例。这是当前推荐的 Agent 入口。
+
+最常用的参数只有几个：
+
+- `model`: 必填，支持直接传 `platform/model`
+- `tools`: 可选，传工具名数组即可
+- `preset` 或 `system`: 二选一；前者复用预设，后者直接写系统提示词
+- `mode`: 可选，默认 `tool-calling`
+- `maxSteps`: 可选，限制最多调用多少轮工具
+
+返回的 `ChatLunaAgent` 主要有 3 个方法：
+
+- `generate(...)`: 普通调用
+- `stream(...)`: 流式调用
+- `asTool(...)`: 包成工具给别的 Agent 用
+
+更完整的教程见：[`/development/call-core-services/agent`](/development/call-core-services/agent)
+
+示例：
+
+```ts
+import type {} from "koishi-plugin-chatluna/services/chat";
+
+const agent = await ctx.chatluna.createAgent({
+  name: "researcher",
+  model: "openai/gpt-5-nano",
+  embeddings: "openai/text-embedding-3-small",
+  tools: ["web-search", "web-browser"],
+  preset: "sydney",
+  mode: "tool-calling",
+  maxSteps: 8,
+});
+
+const result = await agent.generate({
+  prompt: "搜索 OpenAI 最近新闻并整理重点",
+  session,
+  conversationId: "conversation-id",
+});
+
+console.log(result.output);
+```
+
 ### 属性
 
 #### chatluna.platform