話しかけ方

良い出力を得るための実用的なパターンと、ターンを無駄にするパターン。

成果物について具体的に記述する

曖昧：「オンボーディングメールを手伝ってください。」

具体的：「新規 Ahrefs Starter 登録者向けに、最初のプロジェクト設定を促す4通のウェルカムメールシーケンスを作成してください。各メールに1つの CTA を含め、それぞれ120語以内にしてください。」

エージェントは 2 つ目のプロンプトをブリーフとして扱い、下書きを作成します。1 つ目のプロンプトは明確化のための質問を引き起こしますが、これは問題ありませんが、やり取りが 1 往復増えることになります。

返してほしい形式を伝える

「角度、オーディエンス、チャネル、オーナーの列を含む表で返信してください。」
「JSON のみを提供してください。」
「見出し付きのマークダウンで、前置きなしでお願いします。」

デフォルトの出力は会話的です。フォーマットのヒントを使用すると、編集の手間が省けます。

作業をチャットではなくアーティファクトに移す

ファイルやアプリを求めてください。チャットの返信ではなく。再利用したいものがある場合は、ファイルやアプリを求めてください。チャットはスクロールして消えてしまいます。ワークスペース内のファイル、Console 内のページ、またはスケジュールされたジョブは消えません。

例：

「これを ~/workspace/notes/q1-launches.md として保存してください。」
「トラフィック別の上位20件のオーガニックページを表示する Console ページを構築し、毎日更新してください。」
「競合他社がランキングし始めた新しいキーワードを毎週金曜日にメールで送信するジョブをスケジュールしてください。」

「これを覚えておいて」を使う

エージェントは各チャットの開始時に ~/workspace/.memory.md を読み込みます。「これを覚えておいて」と言うと、追記されます。覚えておくと良いこと：

あなたの役割とチーム。
繰り返し使用される用語（製品名、社内の略語）。
文体のルール（「em ダッシュは使用しない」、「常に2つのバリエーションで提供する」など）。
後で点と点を結びつけられるように、長期的な目標。

覚えておくべきでないこと：機密性の高いもの、毎週変わるもの。

一度承認すれば、ターンごとに承認する必要はありません

一部のアクションでは承認カードが表示されます。Python パッケージのインストール、ジョブのスケジュール、新しいドメインの許可リストへの追加、サードパーティ API の接続などです。オーナーまたは管理者が一度クリックすると、エージェントが自動的に再試行します。

承認で何度も止まってしまう場合、通常はリクエストをまとめることで解決できます。「Slack 統合を完全にセットアップし、必要なスコープをすべて一度にリクエストする」ということです。1 枚のカード、1 回のクリックで完了します。

プランを求めるべき時と実行に移るべき時

プランをリクエストする場合：

作業が複数のシステムに関わる場合
何が実現可能かわからない場合
選択肢から選びたい場合

次の場合に実行にジャンプします：

出力が小さく、明確に範囲が定められている。
テンプレートを念頭に置いている（「前回と同じだが、X について」）。

エージェントは、大きな作業の前に質問する傾向があります。「アンケートをスキップして、そのまま構築してください」と指示することで、これを上書きできます。

うまく機能しないもの

スクリーンショットを貼り付けて「何をすべきかわかるよね」と言う。
「もっと良くして」（何と比べて、どの側面で良くするのか？）
「一度にすべてやって」（複数システムにまたがる作業の場合、依頼しなくても Agent A は最初に計画を立てます。）
何百ターンも続く会話。新しいタスクには新しいチャットを開始してください。メモリが重要なコンテキストを引き継ぎます。

内部の仕組み。 各チャットには有限のコンテキストウィンドウがあります。エージェントは、チャットで中間結果をエコーするのではなく、ディスクに書き込むことを優先します。「5,000 行すべてを表示して」と尋ねた場合、代わりにファイルに書き込み、サンプルとカウントを表示します。これは意図的なもので、長いセッションを使いやすく保つためです。