docs: update custom-tool docs

packages/website/src/pages/docs/features/custom-tools/page.tsx

@@ -1,4 +1,3 @@
-import BetaNotice from '@/components/BetaNotice'
 import CodeEditor from '@/components/CodeEditor'
 import { Heading } from '@/components/Heading'
 import { useLanguage } from '@/i18n/context'
@@ -12,115 +11,84 @@ export default function CustomTools() {
 
 			<p className="text-xl text-gray-600 dark:text-gray-300 mb-8 leading-relaxed">
 				{isZh
-					? '通过注册自定义工具，扩展 AI Agent 的能力边界。使用 Zod 定义严格的输入接口，让 AI 安全调用你的业务逻辑。'
+					? '通过注册自定义工具，扩展 AI Agent 的能力边界。使用 Zod 定义输入接口，让 AI 安全调用你的业务逻辑。'
-					: 'Extend AI Agent capabilities by registering custom tools. Use Zod to define strict input schemas for safe business logic calls.'}
+					: 'Extend AI Agent capabilities by registering custom tools. Define input schemas with Zod for safe business logic invocation.'}
 			</p>
 
 			<div className="space-y-8">
 				<section>
-					<Heading id="tool-registration" className="text-2xl font-bold mb-4">
+					<Heading id="define-tools" className="text-2xl font-bold mb-4">
-						{isZh ? '工具注册' : 'Tool Registration'}
+						{isZh ? '定义工具' : 'Define Tools'}
 					</Heading>
 					<p className="text-gray-600 dark:text-gray-300 mb-4">
 						{isZh
-							? '每个自定义工具需要定义四个核心属性：name、description、input schema 和 execute 函数。'
+							? '使用 tool() 辅助函数定义自定义工具，每个工具包含 description、inputSchema 和 execute 三个属性。'
-							: 'Each custom tool requires four core properties: name, description, input schema, and execute function.'}
+							: 'Use the tool() helper to define custom tools with description, inputSchema, and execute.'}
 					</p>
 
 					<CodeEditor
-						code={`import * as zod from 'zod'
+						code={`import { z } from 'zod'
 import { PageAgent, tool } from 'page-agent'
 
-// override internal tool
+const pageAgent = new PageAgent({
-const customTools = {
+  customTools: {
-  ask_user: tool({
+  
-    description:
+	// 
-      'Ask the user or parent model a question and wait for their answer. Use this if you need more information or clarification.',
+    add_to_cart: tool({
-    inputSchema: zod.object({
+      description: 'Add a product to the shopping cart by its product ID.',
-      question: zod.string(),
+      inputSchema: z.object({
+        productId: z.string(),
+        quantity: z.number().min(1).default(1),
+      }),
+      execute: async function (input) {
+        await fetch('/api/cart', {
+          method: 'POST',
+          body: JSON.stringify(input),
+        })
+        return \`Added \${input.quantity}x \${input.productId} to cart.\`
+      },
     }),
-    execute: async function (this: PageAgent, input) {
-      const answer = await do_some_thing(input.question)
-      return "✅ Received user answer: " + answer
-    },
-  })
-}
 
-// remove internal tool
+	// 
-const customTools = {
+    search_knowledge_base: tool({
-  scroll: null, // never scroll
+      description: 'Search the internal knowledge base and return relevant articles.',
-}
+      inputSchema: z.object({
-	
+        query: z.string(),
-const pageAgent = new PageAgent({customTools})
+        limit: z.number().max(10).default(3),
-`}
+      }),
-						language="javascript"
+      execute: async function (input) {
-					/>
+        const res = await fetch(
-				</section>
+          \`/api/kb?q=\${encodeURIComponent(input.query)}&limit=\${input.limit}\`
-
+        )
-				<section>
+        const articles = await res.json()
-					<Heading id="page-filter" className="text-2xl font-bold mb-4">
+        return JSON.stringify(articles)
-						{isZh ? '页面过滤器' : 'Page Filter'}
+      },
-					</Heading>
+    }),
-
-					<BetaNotice />
-
-					<p className="text-gray-600 dark:text-gray-300 mb-4">
-						{isZh
-							? '通过 pageFilter 属性控制工具在哪些页面可见，提升安全性和用户体验。'
-							: 'Control tool visibility on specific pages via the pageFilter property to enhance security and UX.'}
-					</p>
-
-					<CodeEditor
-						code={`pageAgent.registerTool({
-  name: 'approveOrder',
-  description: '审批订单',
-  input: z.object({
-    orderId: z.string(),
-    approved: z.boolean()
-  }),
-  execute: async (params) => {
-    // 审批逻辑
   },
-  // 可选：页面过滤器
-  pageFilter: {
-    // 只在订单管理页面显示
-    include: ['/admin/orders', '/admin/orders/*'],
-    // 排除特定页面
-    exclude: ['/admin/orders/archived']
-  }
 })`}
 						language="javascript"
 					/>
 				</section>
 
 				<section>
-					<Heading id="best-practices" className="text-2xl font-bold mb-4">
+					<Heading id="override-remove" className="text-2xl font-bold mb-4">
-						{isZh ? '最佳实践' : 'Best Practices'}
+						{isZh ? '覆盖与移除内置工具' : 'Override & Remove Built-in Tools'}
 					</Heading>
-					<div className="space-y-4">
+					<p className="text-gray-600 dark:text-gray-300 mb-4">
-						<div className="p-4 bg-yellow-50 dark:bg-yellow-900/20 rounded-lg">
+						{isZh
-							<h3 className="text-lg font-semibold text-yellow-900 dark:text-yellow-300 mb-2">
+							? '使用相同的名称可以覆盖内置工具的行为，设置为 null 则完全移除该工具。'
-								{isZh ? '⚡ 性能优化' : '⚡ Performance Optimization'}
+							: 'Use the same name to override a built-in tool, or set it to null to remove it entirely.'}
-							</h3>
+					</p>
-							<ul className="text-gray-600 dark:text-gray-300 space-y-1 text-sm">
+
-								<li>
+					<CodeEditor
-									{isZh
+						code={`const pageAgent = new PageAgent({
-										? '• 使用 pageFilter 减少不必要的工具加载'
+  customTools: {
-										: '• Use pageFilter to reduce unnecessary tool loading'}
+    scroll: null, // remove scroll tool
-								</li>
+    execute_javascript: null, // remove script execution
-								<li>
+  },
-									{isZh
+})`}
-										? '• 在 execute 函数中实现适当的缓存机制'
+						language="javascript"
-										: '• Implement appropriate caching in execute functions'}
+					/>
-								</li>
-								<li>
-									{isZh
-										? '• 避免在工具中执行耗时的同步操作'
-										: '• Avoid long-running sync operations in tools'}
-								</li>
-							</ul>
-						</div>
-					</div>
 				</section>
 			</div>
 		</div>