Back to Details

intelligence-docs

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Intelligence Landing Page

Intelligence着陆页

/intelligence/overview
is the product landing for CopilotKit Intelligence. New Intelligence features and new Intelligence docs pages must land on that page in the same change. Do not ship a guide that the landing does not name.
/intelligence/overview
是CopilotKit Intelligence的产品着陆页。新的Intelligence功能和新的Intelligence文档页面必须在同一变更中同步到该页面。请勿发布未在着陆页提及的指南。

When To Use

使用场景

Load this skill when:
  • A new Intelligence feature ships (threads, analytics, learning, channels, hosting, inspection, or a later pillar)
  • A page is added, renamed, or removed under 
    showcase/shell-docs/src/content/docs/intelligence/
  • The shared Intelligence overview snippet or feature cards change
Do not load it for OSS frontend guides that do not use Intelligence, or for Inspector pane callouts (
inspector-docs
).
在以下场景中使用本指南：
  • 新的Intelligence功能发布（线程、分析、学习、渠道、托管、检查或后续核心功能）
  • showcase/shell-docs/src/content/docs/intelligence/
    下的页面被添加、重命名或移除
  • 共享的Intelligence概述代码片段或功能卡片发生变更
请勿将其用于不涉及Intelligence的OSS前端指南，或Inspector面板提示（
inspector-docs
）。

Landing sources

着陆页相关资源

Edit these in the same change as the feature or docs page:
SurfaceFile
Hero CTA (
CONNECT_HREF
) and cards
showcase/shell-docs/src/components/content/landing-pages/intelligence-overview.tsx
Table, body, and MDX quickstart link
showcase/shell-docs/src/content/snippets/shared/intelligence/overview.mdx
Section nav
showcase/shell-docs/src/content/docs/intelligence/meta.json
Root sidebar Intelligence group
showcase/shell-docs/src/content/docs/meta.json
Card and CTA tests
showcase/shell-docs/src/components/content/landing-pages/__tests__/intelligence-overview.test.tsx
Snippet order tests
showcase/shell-docs/src/lib/__tests__/intelligence-landing.test.ts
The root overview page only wraps the snippet. Do not duplicate landing copy in 
docs/intelligence/overview.mdx
.
在添加功能或文档页面的同一变更中编辑以下内容：
界面区域文件路径
Hero按钮（
CONNECT_HREF
）和卡片
showcase/shell-docs/src/components/content/landing-pages/intelligence-overview.tsx
表格、正文和MDX快速入门链接
showcase/shell-docs/src/content/snippets/shared/intelligence/overview.mdx
章节导航
showcase/shell-docs/src/content/docs/intelligence/meta.json
根侧边栏Intelligence分组
showcase/shell-docs/src/content/docs/meta.json
卡片和按钮测试
showcase/shell-docs/src/components/content/landing-pages/__tests__/intelligence-overview.test.tsx
代码片段顺序测试
showcase/shell-docs/src/lib/__tests__/intelligence-landing.test.ts
根概述页面仅包裹代码片段，请勿在
docs/intelligence/overview.mdx
中重复着陆页文案。

Procedures

操作流程

Procedure 1: Add a feature or docs page

流程1：添加功能或文档页面

  1. Add or update the guide page under 
    docs/intelligence/
    (or the existing threads/channels path the feature already uses).
  2. Put the page in 
    intelligence/meta.json
    and in the Intelligence group in 
    docs/meta.json
    when it belongs in the sidebar.
  3. Add a row to What the platform adds in the shared snippet. The deeper dive must be a real URL.
  4. If the feature is a user-facing pillar, add a card to 
    FEATURES
    in 
    intelligence-overview.tsx
    with a unique CTA label and the same URL.
  5. If the feature is a named pillar in the hero, add it to the subtitle.
  6. Extend the tests in the same commit. Pin the new CTA href as a literal.
  1. 在
    docs/intelligence/
    下添加或更新指南页面（或使用功能已有的线程/渠道路径）。
  2. 若页面需显示在侧边栏，将其加入
    intelligence/meta.json
    和
    docs/meta.json
    的Intelligence分组中。
  3. 在共享代码片段的平台新增功能部分添加一行内容，其中“深入了解”必须指向真实URL。
  4. 若该功能是面向用户的核心功能，在
    intelligence-overview.tsx
    的
    FEATURES
    中添加一张卡片，包含唯一的按钮标签和相同的URL。
  5. 若该功能是Hero区域中提及的核心功能，将其加入副标题。
  6. 在同一提交中扩展测试，将新的按钮href固定为字面量。

Procedure 2: Rename or move a page

流程2：重命名或移动页面

  1. Update every landing CTA that pointed at the old path: table row, card 
    href
    , quickstart link, and "Which page should I read next?".
  2. Update 
    meta.json
    files.
  3. Update the tests that pin those hrefs.
  1. 更新所有指向旧路径的着陆页按钮：表格行、卡片
    href
    、快速入门链接以及“我应该阅读哪个页面？”链接。
  2. 更新
    meta.json
    文件。
  3. 更新固定这些href的测试。

Procedure 3: Remove a feature or page

流程3：移除功能或页面

  1. Remove the table row, card, subtitle mention, and nav entry.
  2. Remove the matching test assertions.
  3. Do not leave a landing link to a deleted page.
  1. 删除表格行、卡片、副标题提及内容和导航条目。
  2. 删除对应的测试断言。
  3. 请勿保留指向已删除页面的着陆页链接。

Decision Tree

决策树

  • New Intelligence feature or new Intelligence docs page: Procedure 1
  • Rename or move: Procedure 2
  • Remove: Procedure 3
  • Docs exist but landing does not name them: stop and run Procedure 1
  • 新Intelligence功能或新Intelligence文档页面：执行流程1
  • 重命名或移动：执行流程2
  • 移除：执行流程3
  • 文档已存在但着陆页未提及：停止并执行流程1

Red Flags

警示信号

SignalWhat it meansDo instead
Guide merged, landing unchangedReaders cannot find the featureProcedure 1 in the same PR
Card href and table href differTwo stories for one featureUse one URL
CTA points at the marketing site when a docs page existsLanding skips the guidePoint at the docs page
Hero subtitle lists a pillar with no card or table rowCopy without a pathAdd both, or drop the subtitle mention
信号含义正确做法
指南已合并，但着陆页未变更用户无法找到该功能在同一PR中执行流程1
卡片href与表格href不一致同一功能存在两种跳转路径使用统一URL
当文档页面存在时，按钮指向营销网站着陆页跳过了指南指向文档页面
Hero副标题列出了核心功能，但无对应卡片或表格行文案无实际跳转路径同时添加卡片和表格行，或删除副标题提及内容

Error Handling

异常处理

  • No docs page yet: do not invent a guide. You can still add a table row that points at the current public product URL, and replace it when the guide ships.
  • Feature is Intelligence-only but lives outside 
    docs/intelligence/
    :     still add the landing CTA. Use the real path (
    /threads
    , 
    /channels
    , and similar).
  • 暂无文档页面：请勿创建虚构指南。仍可添加指向当前公开产品URL的表格行，待指南发布后替换。
  • 功能仅属于Intelligence但位于
    docs/intelligence/
    之外    ：仍需添加着陆页按钮，使用真实路径（如
    /threads
    、
    /channels
    等）。