> 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).
# 効率的に質問する方法
長くなくてもよい、答えやすい問題で、何をしているのか、実際に何が起きたのか、そして同じ問題を再現するにはどうすればよいのかを、他の人に分かるようにしてください。
まず、質問・再現可能な問題・機能提案のどれかを判断し、それに対応する資料を用意します。
### まず適切な入口を選ぶ
| あなたの状況 | おすすめの入口 |
| ----------------- | ----------------------------------------- |
| 設定の問題か製品の問題か分からない | サイドバー【ヘルプ】→【問題フィードバック】→【フィードバックヘルプアシスタント】 |
| 再現可能な不具合だと確認済み | GitHub Bug Report |
| 新しい機能を追加してほしい | GitHub Feature Request |
| 使い方や案を चर्चाする | GitHub Discussion / Questions |
| 操作手順だけ確認したい | 現在のドキュメントと Cherry Assistant |
Cherry Assistant は現在のインストールパッケージ情報を読み取り、あなたの同意後に必要な診断情報を収集できます。まずマスキング済みのプレビューを表示してから、フィードバックを送信するか診断パッケージを生成します。ログの見方を先に学ぶ必要はありません。
### 問題には何を含めるべきか
{% stepper %}
{% step %}
#### 1. 目標を一文で説明する
例：「Agent に平日の朝、日報を飛書グループに送ってほしいです。」
{% endstep %}
{% step %}
#### 2. 実際の結果と期待する結果を書く
実際の結果：「タスクは正常に実行されたが、飛書にはメッセージが届かなかった。」期待する結果：「実行完了後、指定したグループに日報が1件届く。」
{% endstep %}
{% step %}
#### 3. 最短の再現手順を示す
安定して問題が発生する入口から始め、3〜6ステップでクリックの流れ、選択内容、エラーが出る場所を明確に書いてください。
{% endstep %}
{% step %}
#### 4. 環境を補足する
OS、【設定】→【バージョン情報】に表示されるバージョン、関連するサービス提供元またはチャネル種別を明記してください。API Key やアカウント認証情報は公開しないでください。
{% endstep %}
{% step %}
#### 5. スクリーンショット、録画、またはログを追加する
スクリーンショットにはエラーと該当ページを含めてください。ログは関連する時間帯だけを切り出し、先にマスキングしてください。モデル出力の問題では、入力、モデル、期待フォーマットを添付してください。
{% endstep %}
{% endstepper %}
### そのまま使えるテンプレート
```
タイトル：Agent の定時タスクは正常に実行されたが、飛書チャンネルに結果が届かない
目標：平日 09:00 に運営日報を指定の飛書グループへ送信する。
実際の結果：実行履歴では成功と表示されるが、飛書にメッセージがない。
期待する結果：グループ内に日報メッセージが1件届く。
再現手順：
1. 【設定】→【定時タスク】を開く。
2. 日報タスクを選択し、【実行】をクリックする。
3. タスクの完了を待つ。
4. 飛書グループを確認すると、新しいメッセージがない。
環境：macOS / Cherry Studio の【バージョン情報】に表示されるバージョン / 飛書チャンネル。
試したこと：チャンネルを再有効化した；飛書でボットにテストメッセージを送った。
添付：認証情報を隠したチャンネル状態のスクリーンショット、該当する実行記録。
```
### スクリーンショットとログで削除すべきもの
{% hint style="danger" %}
提出前に、API Key、Authorization、Cookie、ボット Token、App Secret、メールアドレス、完全なローカルパス、チャット内容、業務データを削除してください。秘密情報が公開された場合は、直ちにサービス提供元またはプラットフォームで無効化してください。
{% endhint %}
### 調査を速くするちょっとした習慣
* 毎回、1つの問題だけを再現する；
* 問題が再現する最小構成を使う；
* 問題が安定して発生するかを明記する；
* 「使えない」だけでなく、元のエラーメッセージを添える；
* 問題と関係ない全ログをアップロードしない；
* 同じ Issue を見つけたら、環境情報や新しい手がかりを追記し、重複作成しない。
Cherry Assistant にそのまま代理提出してもらえますか？
できます。【フィードバック】から Cherry Assistant に入り、問題を説明して、明確に提出を依頼してください。診断データの権限を求められ、マスキング済みのプレビューが表示されたうえで、あなたが選んだ方法で処理されます。あなたが GitHub を明示的に要求した場合のみ、GitHub Issue として送られます。
Cherry Assistant にそのまま代理提出してもらえますか？
できます。【フィードバック】から Cherry Assistant に入り、問題を説明して、明確に提出を依頼してください。診断データの権限を求められ、マスキング済みのプレビューが表示されたうえで、あなたが選んだ方法で処理されます。あなたが GitHub を明示的に要求した場合のみ、GitHub Issue として送られます。
---
# 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=&goal=
```
`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.
