- トリアージ
- 診断
- リカバリ
- 要手動対応
すぐに答え
AIでWebhookのデバッグと再試行を行う仕組み
エージェントがZeploからエラーログを取得し、特定のリクエストデータを調査します。問題の原因を特定した後、指示に従ってジョブをキューに再投入します。何が原因で、どう修正すべきかが明確に示されます。
エラーの分類
発生した問題の分類
AIはキューの問題を以下の4つの状態に分類します。
トリアージ
失敗したリクエストの特定
エージェントがログをスキャンし、4xxまたは5xxエラーが発生したリクエストを探し出します。どのリクエストが失敗したかをリスト化します。
診断
ペイロードの調査
失敗したジョブのボディやヘッダーを取得します。ペイロードの形式が正しくなかったのか、あるいはエンドポイントがダウンしていたのかを確認できます。
リカバリ
即時の再試行
エージェントがリクエストをキューに再投入します。ダッシュボードを操作することなく、すぐに再試行が可能です。
要手動対応
手動での介入が必要
エラーがコードのロジック欠陥によるものである場合、エージェントがそれを指摘します。単なる再試行ではなく、ソースコード自体の修正が必要かどうかを判断できます。
ワークフロー
Webhookが失敗した際のエージェントの動き
エージェントはZeploのキューを活用し、検知から実行までを自動で行います。
エラーのスキャン
直近のアクティビティを調査し、正常に完了しなかったリクエストを特定します。
list_queue_logs失敗原因の分析
失敗した特定のジョブの詳細を取得し、ステータスコードとレスポンスボディを確認します。
get_requestペイロードの修正
データの修正を指示すると、エージェントは元のリクエストを修正した新しいバージョンを作成します。
get_request再試行の実行
修正済み、または元のリクエストをキューに送り直し、配信を再度試みます。
enqueue_request
試してみる
以下のプロンプトをコピーして開始
エージェントによるデバッグを開始するために、これらのプロンプトを活用してください。
出発点
これらは開始用のフレーズです。実際のキュー名やリクエストIDは、ご自身の環境に合わせて書き換えてください。
Zeplo Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_5Sj7Y435YhL7etC5VxbdO9r2LKHpV7HuKFTmESFi/mcpClaude Desktop
以下の手順で数秒で接続できます。
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Zeplo capabilities are ready to use.
{
"mcpServers": {
"zeplo-queue-background-job-api-mcp": {
"url": "https://edge.vinkius.com/vk_preview_5Sj7Y435YhL7etC5VxbdO9r2LKHpV7HuKFTmESFi/mcp"
}
}
}'webhooks-prod' キューで、最後に失敗したリクエストを10件表示して。
リクエストID 'req_12345' の詳細を取得して、失敗した理由を教えて。
'notifications' キューの失敗したリクエストを、元のペイロードのまま再試行して。
過去1時間以内にキューで発生した500エラーをすべて探し、リストアップして。
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
ここから始める
一度接続すれば、あとは指示するだけ
一度接続するだけで、エージェントがZeploのキュー全体にアクセスできるようになります。認証情報は、当社のシステム内で暗号化され安全に管理されます。
ZeploをAIに接続するFAQ
動作に関する詳細
- 01
AIはキューから失敗したリクエストを削除できますか?
いいえ。エージェントができるのは、リクエストのリスト取得、詳細取得、および再投入のみです。ログやジョブを削除することはできません。
- 02
AIはZeploのアカウント設定を変更できますか?
いいえ。エージェントは提供されたツールを通じてキューのデータとやり取りするだけです。
- 03
失敗はすべて自動的に再試行されますか?
いいえ。エージェントは失敗を特定しますが、特定のリクエストを再試行するかどうかは、ユーザーが指示する必要があります。
- 04
送信先サーバーから返された正確なエラーメッセージを確認できますか?
はい。エージェントは失敗したリクエストのレスポンスボディを取得し、エラー内容を表示できます。
- 05
AIは新しいキューを作成できますか?
いいえ。エージェントは、すでにZeploアカウント内に存在するキューとリクエストに対してのみ操作を行えます。
Zeploについてさらに詳しく知りたいですか? Zeplo Connectorの全機能を見る
『Zeplo』を Claude、Cursor、ChatGPT などに接続
