diff --git a/docs/02-user-guide/01-interface/07-feature-entry.md b/docs/02-user-guide/01-interface/07-feature-entry.md index 688280d..b5715a7 100644 --- a/docs/02-user-guide/01-interface/07-feature-entry.md +++ b/docs/02-user-guide/01-interface/07-feature-entry.md @@ -189,6 +189,19 @@ | 头脑风暴 | 辅助生成思路、方案或创意 | | 文件与数据处理 | 帮助读取、整理或生成文件内容 | +技能导入常见方式: + +| 导入方式 | 操作说明 | +|---|---| +| 本地文件导入 | 点击技能页面中的导入入口,选择本地技能文件并确认导入 | +| 从链接导入 | 粘贴技能包或技能配置的访问链接,系统读取后完成导入 | +| 从资源库导入 | 在技能资源库中搜索或选择已有技能,点击添加或导入 | +| 对话中导入 | 在对话中说明需要导入的技能,由智能体根据指令协助完成 | + +导入后,可以在技能列表中查看新技能,并根据需要启用、配置或分配给对应智能体。 + +![技能导入](/img/user-guide/feature-entry/skill-import.gif) + ### 3. 自动化 “自动化”卡片用于查看已经设置的定时任务或周期任务。截图中显示有一个“每日发票自动识别任务”,表示系统会在指定时间自动执行。 @@ -256,3 +269,75 @@ | 项目协作 | 配合网站生成、自动化或工作流任务使用 | 新手使用资源管理器时,可以先重点关注三个入口:智能体、技能和自动化。智能体决定“谁来做”,技能决定“能做什么”,自动化决定“什么时候做”。 + +## 三、应用与服务 + +应用与服务模块提供了平台级的配置和管理功能,帮助你连接外部 AI 服务、集成第三方工具,并管理平台扩展。 + +![应用与服务](/img/user-guide/feature-entry/app-service.png) + +点击左侧导航栏中的"应用与服务"图标,进入应用与服务页面。 + +### 核心入口 + +应用与服务页面中的主要功能包括: + +| 编号 | 功能名称 | 作用 | +|---|---|---| +| ① | 算力 Compute | 配置 AI 模型供应商和 API Key,如 OpenAI、阿里云、DeepSeek 等 | +| ② | MCP 服务 MCP Services | 管理外部工具和服务集成,如 Chrome DevTools、文件系统等 | +| ③ | 插件市场 Marketplace | 浏览和安装平台扩展插件,扩展智能体的能力范围 | + +### 配置流程 + +#### 1. 配置算力服务 + +首次使用 DesireCore 时,需要至少配置一个算力服务才能让智能体正常工作: + +1. 进入「应用与服务」→「算力」 +2. 点击「添加供应商」或「配置」 +3. 选择模型供应商(如 OpenAI、阿里云、DeepSeek 等) +4. 填入 API Key 并保存 +5. 在智能体对话中选择对应模型即可使用 + +> 💡 建议同时配置多个供应商,这样当一个服务不可用时可以自动切换。 + +#### 2. 管理 MCP 服务 + +MCP(Model Context Protocol)服务允许智能体连接和使用外部工具: + +1. 进入「应用与服务」→「MCP 服务」 +2. 查看已连接的 MCP 服务列表 +3. 可以启用或禁用特定的 MCP 服务 +4. 新增 MCP 服务需要提供配置信息 + +#### 3. 浏览插件市场 + +插件市场提供了多种扩展功能: + +| 类型 | 说明 | +|---|---| +| 文档处理 | 支持 Word、PDF、Excel、PPT 等文档的生成和解析 | +| 图片生成 | 支持文生图、图片编辑等 AI 绘画功能 | +| 语音合成 | 支持文字转语音,多种音色可选 | +| 视频生成 | 支持文生视频、图片转视频等 | +| 邮件管理 | 支持多邮箱收发、规则配置等 | + +### 常见操作路径 + +| 目标 | 操作路径 | +|------|---------| +| 添加模型供应商 | 应用与服务 → 算力 → 添加供应商 → 填入 Key | +| 启用 MCP 工具 | 应用与服务 → MCP 服务 → 启用所需工具 | +| 安装插件 | 应用与服务 → 插件市场 → 搜索 → 安装 | +| 切换默认模型 | 应用与服务 → 算力 → 选择供应商 → 设为默认 | + +### 新手建议 + +初次使用时,建议按以下优先级配置: + +1. **先配置算力** — 至少添加一个 AI 模型供应商,这是使用智能体的前提 +2. **再浏览 MCP 服务** — 了解有哪些外部工具可以增强智能体的能力 +3. **最后探索插件市场** — 根据实际需求安装扩展插件 + +> ⚠️ 算力配置涉及 API Key 等敏感信息,请妥善保管,不要泄露给他人。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/01-interface/07-feature-entry.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/01-interface/07-feature-entry.md index 93573d9..cf72eb7 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/01-interface/07-feature-entry.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/01-interface/07-feature-entry.md @@ -191,6 +191,19 @@ Common skills include: | Brainstorming | Help generate ideas, options, or plans | | File and data processing | Help read, organize, or generate file content | +Common ways to import skills: + +| Import Method | How to Use It | +|---|---| +| Import from local file | Click the import entry on the Skills page, select a local skill file, and confirm the import | +| Import from link | Paste the access link for a skill package or skill configuration, and the system will read it and complete the import | +| Import from resource library | Search for or select an existing skill in the skill resource library, then click Add or Import | +| Import in a conversation | Describe the skill you want to import in a conversation, and the agent can assist based on your instruction | + +After importing, you can view the new skill in the skill list, then enable, configure, or assign it to the corresponding agent as needed. + +![Skill import](/img/user-guide/feature-entry/skill-import.gif) + ### ③ Automation The “Automation” card is used to view scheduled or recurring tasks. In the screenshot, there is a “Daily invoice auto-recognition task”, which means the system will run it automatically at the specified time. @@ -258,3 +271,75 @@ Suitable scenarios: | Project collaboration | Use it together with website generation, automation, or workflow tasks | For beginners, focus first on three Resource Manager entries: Agents, Skills, and Automation. Agents determine “who does the work”, Skills determine “what can be done”, and Automation determines “when it runs”. + +## 4. Applications & Services + +The Applications & Services module provides platform-level configuration and management features, helping you connect external AI services, integrate third-party tools, and manage platform extensions. + +![Applications & Services](/img/user-guide/feature-entry/app-service.png) + +Click the "Applications & Services" icon in the left navigation bar to enter the Applications & Services page. + +### Core Entry Points + +The main functions on the Applications & Services page include: + +| No. | Function | Purpose | +|---|---|---| +| ① | Compute | Configure AI model providers and API keys, such as OpenAI, Alibaba Cloud, DeepSeek, etc. | +| ② | MCP Services | Manage external tool and service integrations, such as Chrome DevTools, file systems, etc. | +| ③ | Marketplace | Browse and install platform extension plugins to expand agent capabilities | + +### Configuration Flow + +#### 1. Configure Compute Services + +When using DesireCore for the first time, you need to configure at least one compute service for agents to work properly: + +1. Navigate to "Applications & Services" → "Compute" +2. Click "Add Provider" or "Configure" +3. Select a model provider (e.g., OpenAI, Alibaba Cloud, DeepSeek, etc.) +4. Enter your API key and save +5. Select the corresponding model in agent conversations to start using it + +> 💡 We recommend configuring multiple providers so the system can automatically switch when one service is unavailable. + +#### 2. Manage MCP Services + +MCP (Model Context Protocol) services allow agents to connect to and use external tools: + +1. Navigate to "Applications & Services" → "MCP Services" +2. View the list of connected MCP services +3. Enable or disable specific MCP services as needed +4. Adding new MCP services requires providing configuration details + +#### 3. Browse the Marketplace + +The marketplace provides various extension features: + +| Type | Description | +|---|---| +| Document Processing | Support for generating and parsing Word, PDF, Excel, PPT, and other document formats | +| Image Generation | Support for text-to-image, image editing, and other AI drawing features | +| Text-to-Speech | Support for converting text to speech with multiple voice options | +| Video Generation | Support for text-to-video, image-to-video, and other features | +| Email Management | Support for multi-mailbox send/receive, rule configuration, and more | + +### Common Navigation Paths + +| Goal | Navigation Path | +|------|----------------| +| Add a model provider | Applications & Services → Compute → Add Provider → Enter Key | +| Enable MCP tools | Applications & Services → MCP Services → Enable desired tools | +| Install a plugin | Applications & Services → Marketplace → Search → Install | +| Switch default model | Applications & Services → Compute → Select Provider → Set as Default | + +### Tips for Beginners + +When using for the first time, we recommend configuring in the following priority order: + +1. **Configure compute first** — Add at least one AI model provider, which is a prerequisite for using agents +2. **Then browse MCP services** — Understand what external tools are available to enhance agent capabilities +3. **Finally explore the marketplace** — Install extension plugins based on your actual needs + +> ⚠️ Compute configuration involves sensitive information such as API keys. Please keep them secure and do not share them with others. diff --git a/static/img/user-guide/feature-entry/app-service.png b/static/img/user-guide/feature-entry/app-service.png new file mode 100644 index 0000000..b768abc Binary files /dev/null and b/static/img/user-guide/feature-entry/app-service.png differ diff --git a/static/img/user-guide/feature-entry/skill-import.gif b/static/img/user-guide/feature-entry/skill-import.gif new file mode 100644 index 0000000..fb677b0 Binary files /dev/null and b/static/img/user-guide/feature-entry/skill-import.gif differ