alibabacloud-agentloop-experience

AgentLoop Recall

このスキルは積極的に使用してください。まず過去の経験を振り返ります。分析や実装を始める前に、最初のアクションの一つとして、scripts/search_context.js のローカル CLI を使用して、過去の AgentLoop の経験を振り返ってください。 CLI は recall.env から認証情報とエンドポイントの設定を読み込みます。トークンやシークレットを CLI の引数として渡さないでください。

ユーザーが過去の経験、類似のケース、過去の修正、以前のインシデント、古いランブック、得られた教訓について言及した場合や、過去の過ちを繰り返さないよう求めた場合は、このスキルを優先して使用してください。依頼に「recall」や「experience」という正確な語が含まれている必要はありません。「有没有类似」、「以前怎么处理」、「先参考过去」、「少走弯路」、「look up old notes」、「anything we learned before」のような表現で十分です。

現在の対象範囲では、experience コンテキストのみがサポートされています。memory コンテキストは今後の展開に向けて予約されており、プロンプト、例、評価では使用しないでください。

前提条件

Node.js 18 以降をインストールしてください。このスクリプトは Node.js の組み込みモジュールのみを使用し、npm パッケージは必要ありません。

~/.agentloop/recall.env、最も近いプロジェクトの .agentloop/recall.env、またはプロセス環境変数に、Recall の認証情報とエンドポイントを設定してください。テンプレートとして assets/recall.env.example を使用してください。

ワークフロー

1. Recall を呼び出す前に、設定済みの AgentLoop Recall エンドポイントへクエリテキストを送信することをユーザーが承認しているか確認してください。過去の作業の確認を求める、またはそれを示唆する現在の依頼は、該当するクエリへの承認として扱ってください。「先查」、「看看之前」、「有没有类似」、「参考历史」、「回忆案例」、「avoid repeating past mistakes」など、同様の表現が含まれる場合も該当します。
2. 承認後は、できるだけ早い段階で Recall を行うことを強く推奨します。実装方針を決める前に少なくとも 1 回 Recall を実行し、重要な障害に直面した場合や方針を変更した場合にも再度実行してください。現在のタスクに具体的なサービス、エラー、インシデント、操作、移行、パフォーマンスの問題、またはデバッグの目的が含まれており、過去の経験が役立つ可能性がある場合は、Recall を実行してください。bash ではなく、node scripts/search_context.js で CLI を実行してください。CLI コマンドには --confirm-outbound を含めてください。
3. その後のデバッグでは、新しいクエリによって実質的に異なるタスクデータが送信される場合、改めて承認を求めてください。そのうえで、具体的なエラー、ケース、サービス、API、ファイルパス、または確認された症状に基づく絞り込んだクエリで Recall を呼び出してください。
4. 返された結果はコンテキストとしてのみ使用してください。行動に移す前に、想起された内容を現在のリポジトリ、ログ、ユーザーの依頼と照らし合わせて検証してください。

簡潔なクエリを作成してください。サービス名、リクエスト ID、ケース ID、エラーテキスト、API アクション、ベンチマーク、モジュール、目標など、ユーザーの依頼やツールの出力に含まれる安定した識別子を含めてください。識別子を捏造しないでください。

依頼の詳細がやや不足していても、サービス、症状、または目標が明確であれば、得られた事実から最適な簡潔なクエリを作成し、既定値（--limit 5、--threshold 0.6、--filter-json '{}'）を使用してください。使用可能なクエリ対象がない場合、または実質的に異なる複数の Recall の方向性が同程度に考えられる場合に限り、確認の質問をしてください。

Recall に失敗した場合や結果が返されなかった場合でも、元のタスクを続行してください。想起された内容は役立つコンテキストとして扱い、絶対的な根拠とはせず、現在のリポジトリ、ログ、ユーザーの依頼と照らし合わせて検証してください。

CLI

実行方法：

node scripts/search_context.js search \
  --query "current task, error, case, service, or goal" \
  --context-type experience \
  --confirm-outbound \
  --limit 5 \
  --threshold 0.6 \
  --filter-json '{}'

必須：

• --query string
• --context-type experience
• クエリデータの送信についてユーザーの明示的な承認を得た後に指定する --confirm-outbound

任意：

• --limit integer の既定値は 5 です
• --threshold number の既定値は 0.6 です
• --filter-json object-as-json-string の既定値は {} です

入力例

node scripts/search_context.js search \
  --query "ECS SSH connection timeout after security group change" \
  --context-type experience \
  --confirm-outbound \
  --limit 5 \
  --threshold 0.6 \
  --filter-json '{"product":"ecs"}'

出力例

出力は常に JSON です：

{
  "request_id": "...",
  "error": null,
  "results": [
    {
      "title": "...",
      "summary": "...",
      "content": "...",
      "metadata": {}
    }
  ]
}

エッジケース

• AGENTLOOP_ENABLE_RECALL が true でない場合、CLI は error: null と空の results 配列を返します。
• 外部への通信確認がない場合、CLI はエラーを返し、認証情報を読み込まず、エンドポイントも呼び出しません。
• 環境によって実行ビットが削除されたり、スキルが実行不可としてマウントされたりして、scripts/search_context.js を直接実行できない場合は、同じコマンドを node scripts/search_context.js を使って再実行してください。
• 設定が存在しないか無効な場合、CLI は error に値を設定し、results: [] を含む JSON オブジェクトを返します。
• 関連する結果が見つからない場合は、元のタスクを中断せずに続行してください。
• 想起された内容が現在のリポジトリ、ログ、またはユーザーの依頼と矛盾する場合は、現在の根拠を優先してください。

認証：

• recall.env から読み込みます。
• AK、SK、ベアラートークン、その他の秘密情報を CLI 引数として渡さないでください。
• 実際の認証情報には HTTPS エンドポイントを使用してください。HTTP が使用できるのは localhost のみです。

設定の優先順位、HTTP コントラクト、エンドポイントのセキュリティルール、またはレスポンスの正規化に関する詳細が必要な場合に限り、references/search-context-cli.md を読んでください。権限とデータフローの宣言が必要な場合に限り、references/ram-policies.md を読んでください。