調査して修正する

エスカレーション

エージェントが自分に必要としていることの唯一の一覧: 何度繰り返されても依頼ごとに1つのレコードで、対応すると片付けられます。

エスカレーションは、人を必要とする何かの記録です。修正実行が自分を必要として棚上げされると、Polylaneはその依頼を1回だけ記録し、1回だけ知らせます。同じ壁に何回の実行が突き当たっても同じです。

できること

各エスカレーションは、種類、何が問題で何をすべきかを伝える見出し、そして数文の詳細を持ちます。同じ修復で止まった2つ目の修正実行は、再度通知する代わりに開いているエスカレーションに統合されます。カウントが増え、最新のスレッドがその参照に加わります。イシューに対して発生したエスカレーションは、そのイシューの活動タイムラインにも載ります。

エスカレーションの発生元

種類ラベル説明
needs_human_actionNeeds your action修正には自分にしかできないことが必要です。
needs_decisionAwaiting your decisionエージェントは続行前に自分の判断を必要としています。
failedAgent stuck実行は回避できないエラーに遭遇しました。

仕組み

  1. 修正実行が上記のいずれかの種類で棚上げされ、依頼を発生させます。
  2. Polylaneはそれを開いているエスカレーションと照合します。発生元がキーを提供する場合は厳密に、それ以外はテキストの類似度で照合し、一致したものに統合します。
  3. 最初のレコードは1回通知し、統合されたものは静かにしています。
  4. Mark as handledはレコードを片付け、イシューの解決も同様です。片付けられたエスカレーションは繰り返しを吸収しなくなるため、再発すると再び通知されます。依頼が実際には済んでいなかった場合は、同じカードのReopenまたはAPI経由で元に戻せます。
  5. 照合は最後の発生から24時間で失効するため、続いている問題は再び声を上げます。

API経由でエスカレーションを作成し、自分の依頼を同じ一覧に載せることもできます。一覧の取得にはanalytics:readスコープを持つAPIキーが、書き込みにはissues:writeが必要です。APIリファレンスを参照してください。

表示される場所

コンソールで Escalations を開くと、未対応の依頼を確認できます。一覧を検索するか、Handled または All を選択して過去の依頼を探せます。各エスカレーションには、詳細な説明、発生元のイシューとスレッド、関連図、発生履歴を表示するページがあります。対応が完了したら Mark as handled、引き続き対応が必要なら Reopen を選びます。API の _html_url フィールドは、スレッドのないエスカレーションも含め、このページに直接リンクします。

エスカレーションは、依頼を発生させたスレッドにも表示されます。実行の結果カードから依頼を開き、Open full page でレコード全体を表示できます。Threads の Needs you プリセットには、実行が人の対応を待っているスレッドが表示されます。

関連

  • 修正実行: エスカレーションを発生させる棚上げの結果。
  • スレッド: Needs youプリセットと実行ページ。
  • イシュー: エスカレーションが指し戻すレコード。
  • 通知: Polylaneが送るものの背後にあるメール設定。