rate_limited

HTTP 429 · Ludion-Error: rate_limited

何が起きたか

あなたのエージェントは、このサイトが許すよりも速くリクエストを送りました。このコードは、エージェントに頻度の上限を設けるサイトのために Ludion Protocol v0 が定めているものです。オープンソースの Gate は、まだこれを返しません。

サイトがこれを求める理由

サイトは、人とエージェントに同じ処理能力で応えています。上限があれば、忙しいエージェントがひとつあるだけでサイトが遅くなり、他の全員に迷惑がかかる、ということを防げます。

直し方

• 速度を落としてください。Retry-After ヘッダーがあれば、少なくともその時間は待ちます。
• 一度取得したものは、取り直さずにキャッシュします。
• 署名して検証済みのエージェントには、匿名のトラフィックよりも、サイトは高い上限を与えやすくなります。

3分で検証済みになる

Ludion は Web Bot Auth を置き換えません。Web Bot Auth（RFC 9421）でリクエストに署名し、鍵ディレクトリを公開しているエージェントは、Ludion の Gate ではすでに VERIFIED（Depth 0）です。まだ署名していなければ、無料の Ludion CLI で次の手順を踏んでください。

3分は、この道の目標です。チェック DIV-1 として書いてあります。クリーンなコンテナで、init から VERIFIED まで180秒以内。

1. エージェントの身分（Diver）を作ります。Root 鍵はパスフレーズで封をされ、リクエストには署名しません。署名するのは短命の Session 鍵です。

   npx ludion init --name "My Agent" --contact mailto:you@example.com

2. 書き出された公開ファイルを、Signature-Agent のオリジンに HTTPS で置きます。.well-known/http-message-signatures-directory（鍵。application/http-message-signatures-directory+json で返す）と card（名乗り）です。自分のドメインで構いません。登録の受付が始まれば dvr-….agents.ludion.ai にも置けます。

3. リクエストごとに署名します。次のコマンドは Signature-Agent、Signature-Input、Signature を付けた curl をそのまま出力します。署名の寿命は 60 秒なので（仕様 §10.4）、毎回作り直してください。

   npx ludion sign GET https://shop.example/checkout --curl

4. 自己診断します。doctor は公開した鍵ディレクトリと Card を取りに行き、Gate が見るものを確かめます。リダイレクトなしの 200、Content-Type、ディレクトリに今の鍵があること、です。

   npx ludion doctor

これで Gate はあなたのリクエストを VERIFIED と判定します。サイトがそれ以上に求めるもの（Depth、Ballast、Mandate）はその上に積むもので、それぞれ Gate のエラー に説明のページがあります。