diff --git a/docs/02-user-guide/01-interface/07-feature-entry.md b/docs/02-user-guide/01-interface/07-feature-entry.md new file mode 100644 index 0000000..688280d --- /dev/null +++ b/docs/02-user-guide/01-interface/07-feature-entry.md @@ -0,0 +1,258 @@ +# 功能入口与操作路径 + +本节用于帮助新用户理解 DesireCore 的基础操作路径:在哪里选择智能体、在哪里查看回复结果、在哪里输入消息或命令。 + +![对话界面操作路径示意图](/img/user-guide/feature-entry/main1.png) + +## 一、对话界面的三个核心区域 + +进入对话界面后,可以先记住图中的 ①、②、③ 三个区域。大多数基础操作都围绕这三个区域完成。 + +| 编号 | 区域名称 | 作用 | + |---|---|---| + | ① | 智能体与对话列表 | 选择要沟通的智能体,查看历史对话和最近消息 | + | ② | 聊天记录区 | 查看智能体回复、任务执行过程、报告结果和展开内容 | + | ③ | 输入与命令区 | 输入消息、发送任务、上传附件或使用斜杠命令 | + +最常见的使用流程是:先在 ① 选择智能体,再在 ③ 输入问题或任务,最后在 ② 查看回复和执行结果。 + +### ① 智能体与对话列表 + +左侧列表用于选择不同的智能体或历史对话。每一行代表一个智能体或一个对话入口。 + +| 元素 | 说明 | +|---|---| +| 搜索框 | 输入关键词,查找智能体或历史对话 | +| 加号 | 新建对话或添加新的入口 | +| 智能体头像 | 用颜色和文字区分不同智能体 | +| 智能体名称 | 显示当前可选择的专业智能体,例如 DesireCore、数据分析师、网站生成助手 | +| 绿色状态点 | 表示该智能体当前在线或可用 | +| 最近消息 | 显示该智能体最近一次回复或任务摘要 | +| 时间 | 显示最近一次对话或更新的时间 | + +使用方法: + +1. 在左侧列表中找到需要使用的智能体。 +2. 点击智能体名称或对话卡片。 +3. 右侧会切换到对应的聊天页面。 +4. 如果列表较长,可以使用顶部搜索框快速查找。 + +示例: + +| 想做什么 | 可以选择 | +|---|---| +| 让系统分配任务或协调多个智能体 | DesireCore | +| 分析表格、生成图表或报告 | 数据分析师 | +| 生成网站或页面 | 网站生成助手 | +| 识别票据图片 | 票据 OCR 助手 | +| 抓取网页内容 | 网页采集专家 | +| 发送提醒或通知 | 消息通知助手 | + +### ② 对话结果区 + +右侧上方是对话结果区,用于展示智能体的回复内容、任务过程和结果报告。 + +| 元素 | 说明 | +|---|---| +| 消息卡片 | 展示智能体返回的回复、提醒、报告或任务结果 | +| 标题 | 显示本次回复的主题,例如“心跳检查” | +| 摘要内容 | 展示关键结论、评分、状态或说明 | +| 展开全部 | 展开被折叠的长内容,查看完整结果 | +| 历史记录 | 按时间顺序保留之前的对话和执行过程 | + +在截图中,② 区域显示的是“心跳检查”结果。用户可以直接查看系统健康评分、检查摘要,也可以点击“展开全部”查看完整报告。 + +常见结果类型: + +| 类型 | 说明 | +|---|---| +| 普通回复 | 智能体对问题的直接回答 | +| 执行过程 | 展示任务正在处理、检查或生成的过程 | +| 结果报告 | 展示分析报告、检查结果、表格或总结 | +| 异常提示 | 当任务失败或信息不足时,说明原因和下一步需要补充的内容 | +| 操作回执 | 说明任务是否完成、是否等待确认或是否需要继续操作 | + +阅读建议: + +1. 先看标题,确认这条消息属于哪个任务。 +2. 再看摘要,快速判断结果是否正常。 +3. 如果内容被折叠,点击“展开全部”查看完整信息。 +4. 如果智能体要求补充信息,可以在底部输入区继续回复。 + +### ③ 输入与命令区 + +底部是输入与命令区,用于向智能体发送消息、上传内容或调用快捷命令。 + +| 图标 / 元素 | 说明 | +|---|---| +| 加号 | 添加附件或打开更多输入工具 | +| 图片图标 | 上传图片,让智能体识别或处理 | +| 剪刀图标 | 截图、剪裁或截取内容 | +| 输入框 | 输入问题、任务要求或补充说明 | +| 纸飞机按钮 | 发送当前消息 | +| `/` 命令 | 输入斜杠后显示可用命令列表 | + +截图中输入框里输入了 `/`,因此系统显示了可用命令列表。常见命令包括: + +| 命令 | 作用 | +|---|---| +| `/skill` | 调用指定技能 | +| `/new` | 隔离上下文,开始新的对话 | +| `/compact` | 压缩旧消息,保留近期上下文 | +| `/help` | 显示帮助信息 | + +基础操作步骤: + +1. 在输入框中输入你的问题或任务。 +2. 如果需要上传图片,点击图片图标。 +3. 如果需要使用命令,先输入 `/`,再选择对应命令。 +4. 点击右侧纸飞机按钮发送。 +5. 等待智能体在 ② 区域返回结果。 + +示例: + +```text +帮我检查这份报告有没有遗漏重点。 +``` + +```text +帮我把这张票据图片识别成表格。 +``` + +```text +/help +``` + +## 五、入门使用示例 + +如果你想和某个智能体开始对话,可以按照以下步骤操作: + +1. 在 ① 区域选择一个智能体,例如 DesireCore 或数据分析师。 +2. 在 ③ 区域输入你的问题或任务。 +3. 点击纸飞机按钮发送消息。 +4. 在 ② 区域查看智能体回复、任务进度或生成结果。 +5. 如果结果不完整,可以继续在 ③ 区域补充要求。 + +**记忆要点** + +初次使用时,只需要记住图中的三个位置: + +| 位置 | 用途 | +|---|---| +| ① | 选智能体或历史对话 | +| ② | 看回复、任务结果和报告 | +| ③ | 发消息、传文件、用命令 | + +掌握这三个区域后,就可以完成大部分基础对话和任务操作。 + +## 二、资源管理器 + +资源管理器用于集中查看和管理 DesireCore 中的各类资源,包括智能体、技能、自动化任务、工作流、算力服务、邮箱、存储和代码仓库等。 + +![资源管理器示意图](/img/user-guide/feature-entry/resource-manager.png) +点击左侧导航栏中的“文件夹”图标,进入到“资源管理器”页面。 + +资源管理器页面中的 1 到 8 分别代表以下功能: +| 编号 | 功能名称 | 作用 | +|---|---|---| +| ① | 智能体 Agents | 查看和管理当前系统中的智能体,包括在线状态、最近活跃智能体和智能体数量 | +| ② | 技能 Skills | 查看已启用的技能和工具能力,例如创建智能体、删除智能体、brainstorm等 | +| ③ | 自动化 Automation | 查看和管理定时任务、周期任务和自动触发的任务 | +| ④ | 工作流 Workflows | 查看和管理工作流,用于把多个步骤编排成可重复执行的流程 | +| ⑤ | 算力 Compute | 查看可用的 AI 服务、模型服务或基础算力资源 | +| ⑥ | 邮箱 Emails | 查看已连接的邮箱账号,用于邮件同步、发送或相关自动化任务 | +| ⑦ | 存储 Storage | 查看和管理存储连接,用于文件保存、读取或外部存储接入 | +| ⑧ | 代码托管 / 代码仓库 | 查看已连接的代码仓库,例如 GitHub 仓库,用于代码相关任务 | + +### ①. 智能体 + +“智能体”卡片展示当前系统中可用的 Agent。用户可以在这里查看智能体数量、在线状态,以及最近活跃的智能体。 + +适合场景: + +| 场景 | 说明 | +|---|---| +| 找专业助手 | 查看当前有哪些智能体可以使用 | +| 判断是否在线 | 通过绿色状态点确认智能体是否可用 | +| 进入智能体管理 | 点击卡片或箭头进入更详细的智能体列表 | + +### 2. 技能 + +“技能”卡片展示系统已经启用的能力。技能可以理解为智能体能调用的工具或操作能力。 + +常见技能包括: + +| 技能类型 | 作用 | +|---|---| +| 创建智能体 | 根据需求创建新的专业智能体 | +| 删除智能体 | 删除不再需要的智能体 | +| 头脑风暴 | 辅助生成思路、方案或创意 | +| 文件与数据处理 | 帮助读取、整理或生成文件内容 | + +### 3. 自动化 + +“自动化”卡片用于查看已经设置的定时任务或周期任务。截图中显示有一个“每日发票自动识别任务”,表示系统会在指定时间自动执行。 + +适合场景: + +| 场景 | 示例 | +|---|---| +| 定时提醒 | 每天早上 9 点提醒开会 | +| 周期执行 | 每天自动识别发票 | +| 定期检查 | 每隔一段时间检查系统状态或数据变化 | + +### 4. 工作流 + +“工作流”用于把多个步骤组合成一个可重复执行的流程。适合处理固定流程、多步骤任务或需要多个智能体协作的工作。 + +示例: + +```text +收集网页资料 → 整理表格 → 生成报告 → 发送邮件 +``` + +如果当前没有工作流,页面会显示暂无工作流。后续可以在对话中通过 AI 创建和管理工作流。 + +### 5. 算力 + +“算力”卡片展示当前可用的 AI 服务或模型资源,例如 DeepSeek、Kimi、MiniMax Coding Plan 等。 + +用户通常不需要手动配置算力。只有在需要切换模型、调整能力来源或查看服务状态时,才需要进入这个区域。 + +### 6. 邮箱 + +“邮箱”卡片展示已经连接的邮箱账号。连接邮箱后,系统可以配合智能体完成邮件相关任务。 + +适合场景: + +| 场景 | 说明 | +|---|---| +| 邮件通知 | 通过邮箱发送任务结果或提醒 | +| 邮件同步 | 读取或同步指定邮箱内容 | +| 邮件自动化 | 配合自动化任务定期处理邮件 | + +### 7. 存储 + +“存储”卡片用于管理文件存储连接。如果连接了外部存储,系统可以读取、保存或同步相关文件。 + +适合场景: + +| 场景 | 说明 | +|---|---| +| 保存任务结果 | 将报告、表格或图片保存到指定位置 | +| 读取资料 | 从存储中读取文件供智能体处理 | +| 连接外部空间 | 接入云存储或其他文件系统 | + +### 8. 代码托管 + +“代码托管”卡片展示已经连接的代码仓库,例如 GitHub。连接后,智能体可以辅助处理代码、仓库文件和开发任务。 + +适合场景: + +| 场景 | 说明 | +|---|---| +| 查看仓库连接 | 确认 GitHub 等代码平台是否已连接 | +| 处理代码任务 | 让智能体读取、分析或修改代码 | +| 项目协作 | 配合网站生成、自动化或工作流任务使用 | + +新手使用资源管理器时,可以先重点关注三个入口:智能体、技能和自动化。智能体决定“谁来做”,技能决定“能做什么”,自动化决定“什么时候做”。 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 new file mode 100644 index 0000000..93573d9 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/01-interface/07-feature-entry.md @@ -0,0 +1,260 @@ +# Feature Entry Points and Operation Paths + +This section helps new users understand the basic operation paths in DesireCore: where to choose an agent, where to view replies and results, and where to enter messages or commands. + +![Conversation interface operation path](/img/user-guide/feature-entry/main1.png) + +## 1. Three Core Areas of the Conversation Interface + +After entering the conversation interface, first remember the three areas marked ①, ②, and ③ in the image. Most basic operations are completed through these three areas. + +| No. | Area | Purpose | +|---|---|---| +| ① | Agent and Conversation List | Choose the agent you want to talk to, and view conversation history and recent messages | +| ② | Chat History Area | View agent replies, task execution progress, reports, and expanded content | +| ③ | Input and Command Area | Enter messages, send tasks, upload attachments, or use slash commands | + +The most common workflow is: choose an agent in ①, enter your question or task in ③, and then view the reply or result in ②. + +### ① Agent and Conversation List + +The left-side list is used to choose different agents or historical conversations. Each row represents an agent or a conversation entry. + +| Element | Description | +|---|---| +| Search box | Enter keywords to find agents or conversation history | +| Plus button | Create a new conversation or add a new entry | +| Agent avatar | Uses color and text to distinguish different agents | +| Agent name | Shows available professional agents, such as DesireCore, Data Analyst, or Website Generator | +| Green status dot | Indicates that the agent is online or available | +| Recent message | Shows the latest reply or task summary from that agent | +| Time | Shows the most recent conversation or update time | + +How to use: + +1. Find the agent you want to use in the left-side list. +2. Click the agent name or conversation card. +3. The right side switches to the corresponding chat page. +4. If the list is long, use the search box at the top to find an agent quickly. + +Examples: + +| What You Want to Do | Suggested Agent | +|---|---| +| Let the system assign tasks or coordinate multiple agents | DesireCore | +| Analyze tables, generate charts, or create reports | Data Analyst | +| Generate a website or page | Website Generator | +| Recognize invoice or receipt images | Receipt OCR Assistant | +| Extract content from webpages | Web Scraping Specialist | +| Send reminders or notifications | Notification Assistant | + +### ② Chat History Area + +The upper-right area is the chat history area. It displays the agent's replies, task progress, and result reports. + +| Element | Description | +|---|---| +| Message card | Displays replies, reminders, reports, or task results returned by the agent | +| Title | Shows the topic of the current reply, such as “Heartbeat Check” | +| Summary content | Shows key conclusions, scores, status, or explanations | +| Expand all | Expands collapsed long content so you can view the full result | +| History | Keeps previous conversations and execution progress in chronological order | + +In the screenshot, area ② shows the result of a “Heartbeat Check”. Users can directly view the system health score and check summary, or click “Expand all” to view the full report. + +Common result types: + +| Type | Description | +|---|---| +| Normal reply | A direct answer from the agent | +| Execution progress | Shows that a task is being processed, checked, or generated | +| Result report | Shows analysis reports, check results, tables, or summaries | +| Error prompt | Explains the reason when a task fails or when more information is needed | +| Operation receipt | Indicates whether the task is complete, waiting for confirmation, or needs further action | + +Reading tips: + +1. Check the title first to confirm which task the message belongs to. +2. Read the summary to quickly judge whether the result is normal. +3. If the content is collapsed, click “Expand all” to view the full details. +4. If the agent asks for more information, continue replying in the input area at the bottom. + +### ③ Input and Command Area + +The bottom area is used to send messages, upload content, or call quick commands. + +| Icon / Element | Description | +|---|---| +| Plus button | Add attachments or open more input tools | +| Image icon | Upload images for the agent to recognize or process | +| Scissors icon | Take a screenshot, crop, or capture content | +| Input box | Enter questions, task requirements, or additional instructions | +| Paper plane button | Send the current message | +| `/` command | Enter a slash to display the available command list | + +In the screenshot, `/` is entered in the input box, so the system displays the available command list. Common commands include: + +| Command | Purpose | +|---|---| +| `/skill` | Call a specified skill | +| `/new` | Start a new conversation with isolated context | +| `/compact` | Compress older messages while keeping recent context | +| `/help` | Show help information | + +Basic operation steps: + +1. Enter your question or task in the input box. +2. If you need to upload an image, click the image icon. +3. If you need to use a command, type `/` first and then choose the command. +4. Click the paper plane button on the right to send. +5. Wait for the agent to return the result in area ②. + +Examples: + +```text +Check whether this report is missing any key points. +``` + +```text +Convert this receipt image into a table. +``` + +```text +/help +``` + +## 2. Beginner Example + +If you want to start a conversation with an agent, follow these steps: + +1. Choose an agent in area ①, such as DesireCore or Data Analyst. +2. Enter your question or task in area ③. +3. Click the paper plane button to send the message. +4. View the agent's reply, task progress, or generated result in area ②. +5. If the result is incomplete, continue adding requirements in area ③. + +**Key Reminder** + +For first-time use, remember these three positions: + +| Position | Purpose | +|---|---| +| ① | Choose an agent or historical conversation | +| ② | View replies, task results, and reports | +| ③ | Send messages, upload files, and use commands | + +Once you understand these three areas, you can complete most basic conversations and task operations. + +## 3. Resource Manager + +The Resource Manager is used to centrally view and manage different types of resources in DesireCore, including agents, skills, automation tasks, workflows, compute services, email accounts, storage, and code repositories. + +![Resource Manager](/img/user-guide/feature-entry/resource-manager.png) + +Click the “folder” icon in the left navigation bar to enter the Resource Manager page. + +The numbers 1 to 8 in the Resource Manager page represent the following functions: + +| No. | Function | Purpose | +|---|---|---| +| ① | Agents | View and manage agents in the current system, including online status, recently active agents, and total agent count | +| ② | Skills | View enabled skills and tool capabilities, such as creating agents, deleting agents, and brainstorming | +| ③ | Automation | View and manage scheduled tasks, recurring tasks, and automatically triggered tasks | +| ④ | Workflows | View and manage workflows that combine multiple steps into reusable processes | +| ⑤ | Compute | View available AI services, model services, or compute resources | +| ⑥ | Emails | View connected email accounts for email synchronization, sending, or related automation tasks | +| ⑦ | Storage | View and manage storage connections for file saving, reading, or external storage integration | +| ⑧ | Code Hosting / Repositories | View connected code repositories, such as GitHub repositories, for code-related tasks | + +### ① Agents + +The “Agents” card shows the agents available in the current system. Users can view the number of agents, their online status, and recently active agents. + +Suitable scenarios: + +| Scenario | Description | +|---|---| +| Find a professional assistant | See which agents are currently available | +| Check availability | Use the green status dot to confirm whether an agent is available | +| Enter agent management | Click the card or arrow to open the detailed agent list | + +### ② Skills + +The “Skills” card shows the capabilities enabled in the system. A skill can be understood as a tool or operation capability that agents can call. + +Common skills include: + +| Skill Type | Purpose | +|---|---| +| Create agent | Create a new professional agent based on requirements | +| Delete agent | Delete agents that are no longer needed | +| Brainstorming | Help generate ideas, options, or plans | +| File and data processing | Help read, organize, or generate file content | + +### ③ 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. + +Suitable scenarios: + +| Scenario | Example | +|---|---| +| Scheduled reminder | Remind me to attend a meeting every day at 9:00 AM | +| Recurring execution | Automatically recognize invoices every day | +| Regular check | Check system status or data changes at regular intervals | + +### ④ Workflows + +“Workflows” combine multiple steps into a repeatable process. They are suitable for fixed procedures, multi-step tasks, or tasks that require multiple agents to collaborate. + +Example: + +```text +Collect webpage materials → Organize the table → Generate a report → Send an email +``` + +If there is no workflow yet, the page displays that no workflow is available. Later, you can create and manage workflows through AI in a conversation. + +### ⑤ Compute + +The “Compute” card shows the currently available AI services or model resources, such as DeepSeek, Kimi, and MiniMax Coding Plan. + +Users usually do not need to configure compute manually. You only need to enter this area when switching models, adjusting capability sources, or checking service status. + +### ⑥ Emails + +The “Emails” card shows connected email accounts. After an email account is connected, the system can work with agents to complete email-related tasks. + +Suitable scenarios: + +| Scenario | Description | +|---|---| +| Email notification | Send task results or reminders by email | +| Email synchronization | Read or synchronize content from a specified mailbox | +| Email automation | Process emails regularly together with automation tasks | + +### ⑦ Storage + +The “Storage” card is used to manage file storage connections. If external storage is connected, the system can read, save, or synchronize related files. + +Suitable scenarios: + +| Scenario | Description | +|---|---| +| Save task results | Save reports, tables, or images to a specified location | +| Read materials | Read files from storage for agents to process | +| Connect external space | Integrate cloud storage or other file systems | + +### ⑧ Code Hosting + +The “Code Hosting” card shows connected code repositories, such as GitHub. Once connected, agents can help process code, repository files, and development tasks. + +Suitable scenarios: + +| Scenario | Description | +|---|---| +| Check repository connection | Confirm whether GitHub or other code platforms are connected | +| Handle code tasks | Let agents read, analyze, or modify code | +| 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”. diff --git a/static/img/user-guide/feature-entry/agent-list.png b/static/img/user-guide/feature-entry/agent-list.png new file mode 100644 index 0000000..bf0f4ac Binary files /dev/null and b/static/img/user-guide/feature-entry/agent-list.png differ diff --git a/static/img/user-guide/feature-entry/main1.png b/static/img/user-guide/feature-entry/main1.png new file mode 100644 index 0000000..dc0087c Binary files /dev/null and b/static/img/user-guide/feature-entry/main1.png differ diff --git a/static/img/user-guide/feature-entry/resource-manager.png b/static/img/user-guide/feature-entry/resource-manager.png new file mode 100644 index 0000000..564a1fa Binary files /dev/null and b/static/img/user-guide/feature-entry/resource-manager.png differ