> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/question-contact/ask.md).

# 如何高效提问

一个容易回答的问题，不一定很长，但要让别人知道你在做什么、实际发生了什么，以及怎样才能看到同样的问题。

<figure><img src="/files/h04G1tnNwjNDWuVAyUaq" alt="根据使用疑问、可复现问题和功能建议选择提问或反馈入口的流程图"><figcaption><p>先判断是使用疑问、可复现问题还是功能建议，再准备对应材料。</p></figcaption></figure>

## 先选合适入口

| 你的情况         | 推荐入口                           |
| ------------ | ------------------------------ |
| 不确定是配置还是产品问题 | 【设置】→【关于我们】→【反馈】→【使用 Agent 提交】 |
| 已确认是可复现缺陷    | GitHub Bug Report              |
| 希望增加新能力      | GitHub Feature Request         |
| 讨论用法或方案      | GitHub Discussion / Questions  |
| 只需要查操作步骤     | 当前文档与 Cherry Assistant         |

Cherry Assistant 可以读取当前安装包信息，并在你同意后收集必要诊断。它会先展示脱敏后的预览，再提交反馈或生成诊断包；不需要你先学会看日志。

## 问题应包含什么

{% stepper %}
{% step %}

### 1. 一句话说明目标

例如：“我想让 Agent 在工作日早上把日报发到飞书群。”
{% endstep %}

{% step %}

### 2. 写出实际结果和期望结果

实际结果：“任务运行成功，但飞书没有收到消息。”期望结果：“运行完成后，指定群收到一条日报。”
{% endstep %}

{% step %}

### 3. 提供最短复现步骤

从能稳定出现问题的入口开始，用 3–6 步写清点击路径、选择内容和错误出现位置。
{% endstep %}

{% step %}

### 4. 补充环境

写明操作系统、【设置】→【关于我们】中显示的版本、相关服务商或频道类型。不要公开 API Key 和账号凭据。
{% endstep %}

{% step %}

### 5. 添加截图、录屏或日志

截图要包含错误和所在页面；日志只截相关时间段并先脱敏。模型输出问题应附上输入、模型和期望格式。
{% endstep %}
{% endstepper %}

## 可直接使用的模板

```
标题：Agent 定时任务运行成功，但飞书频道没有收到结果

目标：工作日 09:00 把运营日报发送到指定飞书群。
实际结果：运行历史显示成功，飞书无消息。
期望结果：群内收到一条日报消息。

复现步骤：
1. 打开【设置】→【定时任务】。
2. 选择日报任务并点击【运行】。
3. 等待任务完成。
4. 查看飞书群，没有新消息。

环境：macOS / Cherry Studio【关于我们】中显示的版本 / 飞书频道。
已经尝试：重新启用频道；在飞书中给机器人发送测试消息。
附件：已遮挡凭据的频道状态截图、对应运行记录。
```

## 截图和日志要删掉什么

{% hint style="danger" %}
提交前删除 API Key、Authorization、Cookie、机器人 Token、App Secret、邮箱、完整本地路径、聊天内容和业务数据。密钥一旦公开，应立即到服务商或平台撤销。
{% endhint %}

## 让排查更快的小习惯

* 每次只复现一个问题；
* 使用能出现问题的最小配置；
* 说明问题是否稳定发生；
* 不只写“不能用”，附上错误原文；
* 不上传与问题无关的整份日志；
* 发现相同 Issue 时补充环境和新线索，不重复创建。

<details>

<summary>可以直接让 Cherry Assistant 替我提交吗？</summary>

可以。通过【反馈】进入 Cherry Assistant 后说明问题，并明确让它提交。它会征求诊断数据授权、展示脱敏预览，再按你选择的方式处理。只有你明确要求 GitHub 时才会走 GitHub Issue。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/question-contact/ask.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.