Supabase、本番の点検をエージェントに定期で任せる指示文を公開

Supabaseは10月20日、本番のプロジェクトをコーディングエージェントに決まった間隔で点検させる指示文「Agent prompts」を公式ブログで公開した。エラーの急増、セキュリティの問題、遅いクエリ、使用量の伸びを調べ、新しく出た問題か悪くなった問題だけを、測った値と次に見る場所を添えて報告する。ログに読み取り専用のSQLを投げるMCPのツールquery_logsも同時に出た。どれもすでに使える。

4つの指示文と点検の間隔

同社は、本番でアプリを動かすチームの多くが、問題を最初に利用者から聞かされると書く。そこから原因を探してログやデータベースの報告を掘ることになる。今回の指示文は、その掘る作業をエージェントに先回りさせるものだ。同じ発表では、デバッグに対応したagent skillと、管理画面の2つの新しい機能も出た。

ドキュメントには4つの指示文がある。Healthは、APIと認証のサーバーのエラー、エラー率の急増、接続の逼迫を見る。勧める間隔は1時間ごとだ。Securityは、Security Advisorの指摘と、認証や認可の失敗を毎日見る。Performanceは、遅いクエリ、ロック待ち、長く続くセッション、Performance Advisorの指摘を1時間ごとに見る。Resourcesは、リクエスト、エラー、ストレージ、テーブル、接続の伸びを毎日見る。

指摘には、測った値としきい値、次の一手が1つずつ付く。たとえばHealthなら、APIのサーバーエラーが1%を超えて前の1時間の倍になったと報告し、読むべきログの種類と時間帯を示す。しきい値は公開の検出ルールから取っており、自分で変えられる。エージェントは毎回の実行の初めにこのルールを取りに行き、取れなければ評価できないと報告する。点検ができなくなった時や、新しい理由で失敗した時も報告する。問題がなければ、何も報告しない。

すでに報告した指摘を繰り返さないには、使うエージェントの道具が、実行と実行の間に状態を保存できる必要がある。保存できなければ、エージェントは何が新しいか分からないと答える。指示文には、ログやクエリの結果の中にある指示に従わないよう書いてある。

読み取り専用でつなぐ

設定はまず、SupabaseのMCPサーバーを1つのプロジェクトに絞り、読み取り専用でつなぐ。MCPのドキュメントどおりにproject_refとread_only=trueを付けると、すべてのクエリが読み取り専用のPostgresのユーザーで動く。次に指示文を写し、一度手で動かして報告を読む。そのうえで、Claude Codeの/scheduleで作るroutine、Codexの定期タスク、Cursorの自動実行のどれかに登録する。

同社は、定期の実行は途中で人に承認を求められないので、指示文が使う読み取り専用のツールだけを前もって許可するよう書く。小さなプロジェクトでは、指示文を1つ選び、毎日か毎週の間隔から始めるよう勧める。報告はエージェントの道具に届く。Linearの課題など、ほかの送り先は指示文に足せる。

ログを引くquery_logs

query_logsは、プロジェクトのログに読み取り専用のSQLを投げるMCPのツールだ。1回で最大24時間分を読み、ログの項目をまたいで集計や結合ができる。Healthの指示文は、これで1時間ごとのエラーを前の1時間と比べる。

supabaseのagent skillは、デバッグにも対応した。PostgresやPostgRESTのエラーコード、空の結果、思わぬRLSの拒否に当たると、記憶で判断せず、まず最新の可観測性のドキュメントを読みに行くよう指示する。管理画面では、AdvisorsにHealthのタブが加わり、Data API、認証、Storage、Edge Functionsのエラー率が普段より高い所を示す。Database Connectionsのページでは、長く動くクエリや止まったクエリを見つけ、SQLを書かずに止められる。自前で動かすSupabaseでも、最初から使える。

編集部の見方

Supabaseで小さなサービスを動かしている人なら、まずHealthの指示文を1つ、毎日の間隔で回してみるとよい。利用者に言われる前に、エラーの増え方を数字で知れる。ただ、エージェントに本番を見せる以上、読み取り専用でつなぐことと、許可するツールを絞ることは外せない。実行の間に状態を残せない道具では、何が新しいか分からないという返事になる。自分の道具がそれに耐えるかは、一度手で回して確かめたい（編集部の読み）。