> 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/docs/jp/question-contact/ask.md).

# 効率的な質問の仕方

答えやすい問題で、長くある必要はありませんが、相手に何をしているのか、実際に何が起きたのか、同じ問題をどう確認できるのかが分かるようにしてください。

<figure><img src="/files/04d811002cab21c02f3346c0fdb99e4e217b137c" alt="根据使用疑问、可复现问题和功能建议选择提问或反馈入口的流程图"><figcaption><p>まずは疑問、再現可能な不具合、機能提案のどれに当たるかを判断し、それに対応する資料を準備してください。</p></figcaption></figure>

## まず適切な入口を選択

| あなたの状況             | 推奨入口                                    |
| ------------------ | --------------------------------------- |
| 設定の問題か製品の問題か分からない  | 【設定】→【私たちについて】→【フィードバック】→【Agent を使って送信】 |
| 再現可能な不具合であることを確認済み | GitHub Bug Report                       |
| 新しい機能を追加してほしい      | GitHub Feature Request                  |
| 使い方や案について議論したい     | GitHub Discussion / Questions           |
| 操作手順だけ確認したい        | 現在のドキュメントと Cherry Assistant             |

Cherry Assistant は現在のインストールパッケージ情報を読み取り、あなたの同意後に必要な診断情報を収集できます。まず匿名化したプレビューを表示してから、フィードバックを送信するか診断パッケージを生成します。事前にログの見方を覚えておく必要はありません。

## 問題には何を含めるべきか

{% stepper %}
{% step %}

### 1. 目的を一文で説明する

例：「Agent に平日の朝、日報を Feishu のグループに送ってほしい。」
{% endstep %}

{% step %}

### 2. 実際の結果と期待する結果を書く

実際の結果：「タスクの実行は成功したが、Feishu にはメッセージが届かなかった。」期待する結果：「実行完了後、指定したグループに日報が 1 件届く。」
{% endstep %}

{% step %}

### 3. 最短の再現手順を示す

問題が安定して発生する入口から始め、3〜6 ステップでクリックの流れ、選択した内容、エラーが発生した場所を明確に書いてください。
{% endstep %}

{% step %}

### 4. 環境を補足する

OS、【設定】→【私たちについて】に表示されているバージョン、関連するサービス提供者またはチャンネルの種類を記載してください。API Key やアカウント認証情報は公開しないでください。
{% endstep %}

{% step %}

### 5. スクリーンショット、録画、ログを追加する

スクリーンショットにはエラーとその画面を含めてください。ログは関連する時間帯だけを切り出し、先に匿名化してください。モデル出力の問題では、入力、モデル、期待する形式を添付してください。
{% endstep %}
{% endstepper %}

## そのまま使えるテンプレート

```
タイトル：Agent の定時タスクは成功したが、Feishu チャンネルに結果が届かない

目的：平日 09:00 に運営日報を指定した Feishu グループへ送信する。
実際の結果：実行履歴では成功と表示されるが、Feishu にはメッセージがない。
期待する結果：グループ内に日報メッセージが 1 件届く。

再現手順：
1.【設定】→【定時タスク】を開く。
2. 日報タスクを選択して【実行】をクリックする。
3. タスク完了まで待つ。
4. Feishu グループを確認すると、新しいメッセージはない。

環境：macOS / Cherry Studio の【私たちについて】に表示されているバージョン / Feishu チャンネル。
試したこと：チャンネルを再有効化した；Feishu でボットにテストメッセージを送信した。
添付：認証情報を隠したチャンネル状態のスクリーンショット、対応する実行記録。
```

## スクリーンショットとログで削除すべきもの

{% hint style="danger" %}
送信前に API Key、Authorization、Cookie、ボット Token、App Secret、メールアドレス、完全なローカルパス、チャット内容、業務データを削除してください。秘密情報が公開された場合は、すぐにサービス提供者またはプラットフォームで失効させてください。
{% endhint %}

## 調査を速くするためのちょっとした習慣

* 一度に再現するのは 1 つの問題だけにする；
* 問題が出る最小構成を使う；
* 問題が安定して発生するかを説明する；
* 「使えない」だけでなく、エラーの原文を添える；
* 問題と関係のないログ全体はアップロードしない；
* 同じ 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/docs/jp/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.
