docs: update tool capability docs#24
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
There was a problem hiding this comment.
Pull request overview
Updates DesireCore documentation to reflect recent product changes by reorganizing the built-in tools reference (grouped by capability domains) and adding new capability pages (Web Access v2, Media Generation, App/Service Catalog) in both docs/ and i18n/en/.
Changes:
- Refactors the built-in tools reference pages to a domain-based table format, including new tool families (Web Access, tasks/context, media, export).
- Adds new capability docs for Web Access, Media Generation, and the App/Service Catalog (CN + EN mirrors).
- Updates the integrations overview and built-in tools guide to reference the new capability pages and newer tool concepts (skill-scoped tools, task board, compaction, heartbeat).
Reviewed changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated 11 comments.
Show a summary per file
| File | Description |
|---|---|
| i18n/en/docusaurus-plugin-content-docs/current/05-more/05-builtin-tools-reference.md | Replaces detailed per-tool sections with a domain-grouped reference table and adds links to capability pages. |
| i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/07-web-access.md | New EN page documenting Web Access v2 and its skill-scoped browser tooling. |
| i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/08-media-generation.md | New EN page documenting media provider requirements and Generate* tools. |
| i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/09-app-service-catalog.md | New EN page describing the app/service catalog and approval model. |
| docs/05-more/05-builtin-tools-reference.md | CN counterpart of the built-in tools reference refactor, including new tool domains and capability links. |
| docs/02-user-guide/09-capabilities/07-web-access.md | New CN page for Web Access v2 and safety boundaries. |
| docs/02-user-guide/09-capabilities/08-media-generation.md | New CN page for media generation providers, tool usage, and cost/approval notes. |
| docs/02-user-guide/09-capabilities/09-app-service-catalog.md | New CN page for app/service catalog concepts, approvals, and troubleshooting states. |
| docs/02-user-guide/09-capabilities/06-integrations-overview.md | Adds App/Service Catalog into the integrations overview and links to it. |
| docs/02-user-guide/09-capabilities/02-builtin-tools.md | Expands built-in tools guide with Web Access/tool families, tasks/context tools, heartbeat response, and media/export tools. |
| docs/02-user-guide/09-capabilities/01-tool-system.md | Extends tool-system overview with skill-scoped tools and examples. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| | `SitePattern*` | Read or write site usage patterns | Low-Medium | May be needed | | ||
| | `LocalBookmarks` | Search local browser bookmarks/history hints | Low | No | | ||
|
|
||
| Browser, SitePattern, and LocalBookmarks tools are Web Access skill-scoped tools. See [Web Access](../user-guide/capabilities/web-access). |
| | `UnderstandImage` | Use a vision provider | Low-Medium | Depends | | ||
| | `MathCalc` | Deterministic high-precision calculation | Low | No | | ||
|
|
||
| Media generation tools require a configured `image_gen`, `video_gen`, or image processing provider. See [Media Generation](../user-guide/capabilities/media-generation). |
Comment on lines
+54
to
+57
| | `Delegate` | Delegate work to another agent, team, or preset flow | Medium | Depends | | ||
| | `SpawnAgent` | Create a temporary sub-agent | Medium | Usually | | ||
| | `Handoff` | Transfer work to another agent | Medium | Usually | | ||
| | `RequestHelp` | Ask a persistent agent for help | Medium | Usually | |
| | `SitePattern*` | 读取或写入站点经验 | 低 - 中 | 写入时可能需要 | | ||
| | `LocalBookmarks` | 查询本机浏览器书签和历史线索 | 低 | 否 | | ||
|
|
||
| `Browser*`、`SitePattern*` 和 `LocalBookmarks` 属于 Web Access v2 的 Skill-scoped 工具，只有对应技能启用后才会暴露。详见 [Web Access](../user-guide/capabilities/web-access)。 |
| | `UnderstandImage` | 调用视觉理解 provider | 低 - 中 | 视 provider 而定 | | ||
| | `MathCalc` | 高精度确定性计算 | 低 | 否 | | ||
|
|
||
| 媒体生成工具需要对应的 `image_gen`、`video_gen` 或图像处理 provider。详见 [媒体生成](../user-guide/capabilities/media-generation)。 |
|
|
||
| Web Access 技能启用后，智能体可以使用浏览器标签页访问动态网页、登录态页面和需要 JavaScript 的站点。工具族包含导航、点击、滚动、截图、执行受控脚本、文件上传和关闭标签页等能力。 | ||
|
|
||
| **典型场景**：阅读需要登录的网页、操作动态表单、采集 SPA 页面、复用站点经验。详见 [Web Access](./web-access)。 |
| | 风险等级 | 低 | | ||
| | 需要确认 | 否 | | ||
|
|
||
| 整理当前长对话，把较早消息压缩成摘要，帮助模型继续处理长任务。详见 [上下文控制](../conversations/context-control)。 |
| | 风险等级 | 中 | | ||
| | 需要确认 | 视供应商和费用而定 | | ||
|
|
||
| 调用已配置的图像或视频生成 provider，支持文生图、图生图、文生视频、参考素材和首尾帧等能力。详见 [媒体生成](./media-generation)。 |
|
|
||
| 这篇文档帮助你快速了解 DesireCore 所有集成能力的全貌，然后指引你到具体文档深入阅读。 | ||
|
|
||
| 较新的 DesireCore 还提供 [应用与服务目录](./app-service-catalog)，用于管理应用安装、服务注册、健康探测、启停更新和审批请求。 |
| | **Computer Use** | 通过 HostAgent 操控桌面和移动设备的 GUI | [GUI 桌面自动化](./computer-use) | | ||
| | **邮件** | 统一管理 Gmail / Outlook / IMAP 邮箱 | [邮件管理](../email/overview) | | ||
| | **工作流** | 用可视化 DSL 编排触发器、代码、LLM、Agent 和人工确认节点 | [任务编排](../../concepts/task-orchestration) | | ||
| | **应用与服务目录** | 管理应用安装、派生服务、审批和健康状态 | [应用与服务目录](./app-service-catalog) | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates tool and capability documentation based on recent v10.0.46-v10.0.82 product changes.
Stack
Base:
codex/docs-conversation-task-workflows.Validation
npm run typechecknpm run build