diff --git a/packages/website/src/components/DocsLayout.tsx b/packages/website/src/components/DocsLayout.tsx index 944edc7..11064f7 100644 --- a/packages/website/src/components/DocsLayout.tsx +++ b/packages/website/src/components/DocsLayout.tsx @@ -34,7 +34,7 @@ export default function DocsLayout({ children }: DocsLayoutProps) { items: [ { title: t('nav.model_integration'), path: '/docs/features/model-integration' }, { title: t('nav.custom_tools'), path: '/docs/features/custom-tools' }, - { title: t('nav.knowledge_injection'), path: '/docs/features/knowledge-injection' }, + { title: t('nav.knowledge_injection'), path: '/docs/features/instructions' }, { title: t('nav.security_permissions'), path: '/docs/features/security-permissions' }, { title: t('nav.data_masking'), path: '/docs/features/data-masking' }, ], diff --git a/packages/website/src/docs/features/instructions/page.tsx b/packages/website/src/docs/features/instructions/page.tsx new file mode 100644 index 0000000..6689672 --- /dev/null +++ b/packages/website/src/docs/features/instructions/page.tsx @@ -0,0 +1,135 @@ +import { useTranslation } from 'react-i18next' + +import CodeEditor from '@/components/CodeEditor' + +export default function KnowledgeInjection() { + const { i18n } = useTranslation() + const isZh = i18n.language === 'zh-CN' + + return ( +
+

{isZh ? '知识注入' : 'Instructions'}

+ +

+ {isZh + ? '通过 instructions 配置,为 AI 注入系统级指导和页面级上下文,让它更好地理解你的业务场景。' + : 'Use the instructions config to inject system-level directives and page-specific context, helping the AI better understand your application.'} +

+ + {/* System Instructions */} +
+

+ {isZh ? '系统级指导 (System Instructions)' : 'System Instructions'} +

+ +

+ {isZh + ? '全局提示词,应用于所有任务。定义 AI 的角色、工作风格和行为边界。' + : "Global directives applied to all tasks. Define the AI's role, working style, and behavioral boundaries."} +

+ + +
+ + {/* Page Instructions */} +
+

+ {isZh ? '页面级指导 (Page Instructions)' : 'Page Instructions'} +

+ +

+ {isZh + ? '动态回调函数,在每个 step 执行前调用,根据当前页面 URL 返回特定提示词。适用于为不同页面提供针对性的操作引导。' + : 'A dynamic callback invoked before each step. Returns page-specific instructions based on the current URL. Useful for providing targeted guidance on different pages.'} +

+ + { + if (url.includes('/checkout')) { + return \` +This is the checkout page. +- Verify shipping address before proceeding +- Check if any discounts are applied +- Confirm the total amount with the user +\` + } + + if (url.includes('/products')) { + return \` +This is the product listing page. +- Use filters to narrow down search results +- Check stock availability before adding to cart +\` + } + + return undefined // No special instructions for other pages + } + } +})`} + /> +
+ + {/* How It Works */} +
+

{isZh ? '工作原理' : 'How It Works'}

+ +

+ {isZh + ? '在每个执行步骤之前,page-agent 会将 instructions 拼接到用户提示词中:' + : 'Before each execution step, page-agent prepends the instructions to the user prompt:'} +

+ + + +You are a professional e-commerce assistant. +... + + +This is the checkout page. +... + + + +`} + /> + +
    +
  • + {isZh + ? '如果 system 为空,则不输出 标签' + : 'If system is empty, the tag is omitted'} +
  • +
  • + {isZh + ? '如果 getPageInstructions 返回空值,则不输出 标签' + : 'If getPageInstructions returns empty, the tag is omitted'} +
  • +
+
+
+ ) +} diff --git a/packages/website/src/docs/features/knowledge-injection/page.tsx b/packages/website/src/docs/features/knowledge-injection/page.tsx deleted file mode 100644 index 43795c3..0000000 --- a/packages/website/src/docs/features/knowledge-injection/page.tsx +++ /dev/null @@ -1,162 +0,0 @@ -import BetaNotice from '@/components/BetaNotice' -import CodeEditor from '@/components/CodeEditor' - -export default function KnowledgeInjection() { - return ( -
-

知识库注入

- - - -

- 通过多层次的知识注入,让 AI 深度理解你的业务场景和应用逻辑,实现更精准的自动化操作。 -

- - {/* Custom Instruction */} -
-

Instruction - 系统指令

- -
-

- 🎯 系统级指令 -

-

- 为 AI 设定全局行为准则和工作风格。 -

-
    -
  • 定义 AI 的工作风格和交互方式
  • -
  • 设置安全边界和操作限制
  • -
  • 指定错误处理和异常情况的应对策略
  • -
  • 配置输出格式和反馈机制
  • -
-
- - -
- - {/* App Knowledge */} -
-

App Knowledge - 应用知识

- -
-

- � 业务领域知识 -

-

- 注入应用的核心业务知识,包括产品介绍、操作流程、术语定义等,让 AI 理解业务上下文。 -

-
-
-

产品知识

-
    -
  • 产品功能和特性介绍
  • -
  • 用户角色和权限体系
  • -
  • 业务规则和约束条件
  • -
-
-
-

操作指南

-
    -
  • 标准操作流程定义
  • -
  • 异常情况处理方案
  • -
  • 术语和概念解释
  • -
-
-
-
- - -
- - {/* Page Knowledge */} -
-

Page Knowledge - 页面知识

- -
-

- 📄 页面级精准指导 -

-

- 为特定页面提供精确的操作指导和元素说明,让 AI 准确理解页面结构和交互逻辑。 -

-
-
-

元素标注

-

为页面元素添加语义化描述

-
-
-

交互说明

-

- 定义元素的交互行为和预期结果 -

-
-
-

页面逻辑

-

- 说明页面的业务逻辑和状态变化 -

-
-
-
- - -
-
- ) -} diff --git a/packages/website/src/i18n/locales/en-US/common.ts b/packages/website/src/i18n/locales/en-US/common.ts index a483f00..89d8b49 100644 --- a/packages/website/src/i18n/locales/en-US/common.ts +++ b/packages/website/src/i18n/locales/en-US/common.ts @@ -29,7 +29,7 @@ export default { limitations: 'Limitations', model_integration: 'Model Integration', custom_tools: 'Custom Tools', - knowledge_injection: 'Knowledge Injection', + knowledge_injection: 'Instructions', security_permissions: 'Security & Permissions', data_masking: 'Data Masking', cdn_setup: 'CDN Setup', diff --git a/packages/website/src/i18n/locales/zh-CN/common.ts b/packages/website/src/i18n/locales/zh-CN/common.ts index 35ae7af..7c86540 100644 --- a/packages/website/src/i18n/locales/zh-CN/common.ts +++ b/packages/website/src/i18n/locales/zh-CN/common.ts @@ -28,7 +28,7 @@ export default { limitations: '使用限制', model_integration: '模型接入', custom_tools: '自定义工具', - knowledge_injection: '知识库注入', + knowledge_injection: '知识注入', security_permissions: '安全与权限', data_masking: '数据脱敏', cdn_setup: 'CDN 引入', diff --git a/packages/website/src/router.tsx b/packages/website/src/router.tsx index 9576ef4..9bd3bb8 100644 --- a/packages/website/src/router.tsx +++ b/packages/website/src/router.tsx @@ -5,7 +5,7 @@ import Header from './components/Header' // Features pages import CustomTools from './docs/features/custom-tools/page' import DataMasking from './docs/features/data-masking/page' -import KnowledgeInjection from './docs/features/knowledge-injection/page' +import Instructions from './docs/features/instructions/page' import ModelIntegration from './docs/features/model-integration/page' import SecurityPermissions from './docs/features/security-permissions/page' import BestPractices from './docs/integration/best-practices/page' @@ -80,11 +80,11 @@ export default function Router() { - +
- +