エラーをAIに相談する：スクリーンショットを送る？テキストをコピーする？

MacのエラーについてAIアシスタントに相談するときは、可能であればメッセージをテキストとしてコピーしてください。文字が画像や選択できないダイアログにしかない場合はOCRを使います。問題の原因が画面の見た目に関係する場合はスクリーンショットも添え、すべてのエラーを初めから画像として送る必要はありません。

根拠を保てる入力方法を選ぶ

ビルドの失敗と、ボタンの位置ずれでは、説明に必要な情報が異なります。

• テキスト： 正確な文字が重要なエラーメッセージ、スタックトレース、コマンド、設定値。役に立つ改行や前後の出力も残します。
• スクリーンショット： 一部が切れたパネル、想定外の色、重なったコントロールなど、位置関係が問題になる場合。要素同士の関係が分かる範囲を含めます。
• 両方： 画面が崩れており、ダイアログ内のエラーコードも重要な場合。状況を示す画像と、確認済みのエラーテキストを添えます。

ターミナルやエディタから出力をコピーできるなら、スクリーンショットの文字認識より、コピーしたテキストを使いましょう。OCRでは転記が一段階増えるため、句読点、インデント、0とOのような文字が変わることがあります。

Frsetで選択できないエラーを抽出する

アプリのエラーダイアログに表示されたメッセージを選択できない場合を考えてみましょう。Frsetのスクリーンショットツールを使って、次の手順で抽出できます。

1. メニューバーまたは設定済みのショートカットからScreenshotを起動します。
2. メッセージと、理解に必要な周辺のラベルを選択します。
3. スクリーンショットツールバーでExtract Textを選びます。
4. OCRの結果を元の表示と照合し、特にエラーコード、パス、句読点を確認します。
5. 誤りがあれば修正し、必要なテキストをコピーします。
6. エラーの原因となった操作と一緒に、AIとの会話へ貼り付けます。

FrsetにはmacOS 13以降が必要です。画面を収録するには、macOSの該当する画面収録の許可が必要です。OCRにはAppleのローカル文字認識を使うため、AI APIキーは必要ありません。画像がすでにFrsetのクリップボード履歴にある場合は、もう一度撮影せず、そこからExtract Textを使えます。

保存済みの画像では、対応するシステムと言語であればAppleのプレビューにあるテキスト認識機能も使えます。基本の手順は画像から文字をコピーする方法をご覧ください。

メッセージだけでは分からない背景を添える

エラーだけで問題の全体像が分かることはほとんどありません。たとえば、依存関係を変更したあとでビルドに失敗したと説明し、コマンド、その出力、関連する設定を添えます。利用できるからといって、関係のないログをすべて貼り付けないようにしましょう。

送信前に、次の情報を含めてください。

• 何をしようとして、代わりに何が起きたか。
• エラーに関係するアプリ、ランタイム、依存関係のバージョン。
• 正確なメッセージと、原因を理解するために必要な前後の出力。
• 最近変更した内容と、すでに試したこと。

複数のアプリから情報を集める場合は、Frsetのクリップボード履歴を使って、内容、タイトル、エイリアスから以前のコピーを探せます。コマンド、出力、設定のどれか分かるようラベルを付けて貼り付けましょう。複数のテキストを選ぶと改行で連結されます。送信前に、まとめたメッセージを確認してください。

トークン削減を固定の比率ではなく問いとして考える

文字の多いスクリーンショットを、正確な短い抜粋に置き換えれば、質問で必要になる入力を減らせる場合があります。ただし、特定の削減量や同じ回答が保証されるわけではありません。画像の処理や料金はサービス、モデル、画像サイズによって異なります。その要因はAnthropicのビジョン機能ガイドで説明されています。

入力を短くするためだけに、視覚的な根拠を取り除かないでください。ボタンが隠れている理由を尋ねるとき、ラベルをOCRで読み取っても、別のパネルと重なっている様子は分かりません。スクリーンショットを残し、文字の正確さが重要なところにはテキストも添えましょう。

共有する内容を確認する

送信するメッセージから、認証情報、非公開URL、無関係な個人情報や顧客情報を取り除いてください。抽出されたテキストだけでなく、画像も確認しましょう。ローカルOCRを使っても、オンラインアシスタントに送ればローカルのままではありません。選んだサービスに内容を共有することになります。

説明を確認し終えるまで、元のスクリーンショットやログを残してください。アシスタントからコマンドを提案されたら、実行前に目的と対象を確認します。繰り返し使うスニペットについては、コピーしたコードやコマンドを保存する方法もご覧ください。