Fallback

Fallback

  ______      _ _
 |  ____|    | | |
 | |__  __ _ | | |__   __ _  ___| | __
 |  __|/ _` || | '_ \ / _` |/ __| |/ /
 | |  | (_| || | |_) | (_| | (__|   <
 |_|   \__,_||_|_.__/ \__,_|\___|_|\_\

       find the route forward

Fallback

自律型エージェント向けの、小額課金の復旧・判断ユーティリティです。

エージェントが行き詰まったとき、Fallback は大規模な推論ループを無駄にせず、次に取るべき安全な行動を見つけられるよう支援します。

source_route どこを探せばよいですか？（$0.02）
error_route なぜ失敗したのですか？（$0.002）
request_repair リクエストを安全に修正できますか？（$0.005）
stop_search さらに検索する価値はありますか？（$0.003）

Fallback を使う

AI エージェントが情報源を見つけ、失敗を診断し、リクエストを修正し、検索をやめるタイミングを判断するための従量課金ツールです。Fallback は、自動化が行き詰まる場面で自律型エージェントに小規模で決定論的なユーティリティを提供します。適切な情報源を見つける、失敗したリクエストを診断する、利用可能な証拠に基づいてリクエストを修正する、さらに検索や有料の取得を行う価値があるか判断するといった用途に使えます。

ホステッドサービス

MCP エンドポイント：https://fallback.factrail.online/mcp\ HTTP API ベース：https://fallback.factrail.online\ 支払い：x402 V2 の従量課金。ネットワーク、アセット、金額、受取人については、その都度最新のチャレンジを確認してください。
エージェントスキル：skill.md
OpenAPI：openapi.json
ネットワーク：Base メインネット、正規の USDC
リリース：v0.1.0-beta.1

ツール

• source_route（$0.02）：どこを探せばよいですか？ 信頼性が高い、または機械可読な情報源を探します。
• error_route（$0.002）：呼び出しが失敗したのはなぜですか？ 失敗したリクエストを分類し、範囲を限定した次のアクションを提案します。
• request_repair（$0.005）：リクエストを安全に修正できますか？ 呼び出し元から提供された証拠に裏付けられる、最小限の変更を提案します。
• stop_search（$0.003）：さらに検索する価値はありますか？ 証拠と残りの費用に照らして、範囲を限定した検索を続ける妥当性を判断します。

これらのツールはエージェントの推論に取って代わるものではなく、stop_search が普遍的な不存在を証明することもありません。

エージェントが使用すべき場面

source_route は、エージェントが必要なもの、そしてどの提供元（ドメインまたは開始 URL）から取得するかは分かっているものの、API、OpenAPI 仕様、一括ダウンロード、データセット、フィードなど、機械可読な形式で取得する方法が分からない場合に使用します。

• 適しています：「Eurostat から最新の人口データセットを取得する」「この機関の統計を取得できる JSON/CSV の経路を探す」など、エージェントがページを一つずつ閲覧し始める前に使います。
• 適していません：一般的なウェブ調査、事実に関する質問への回答、事実の検証（情報源に基づく事実については、FACTRAIL MCP を参照してください）。

結果の読み方：

• status: routes_found：順番に経路を試してください。score は決定論的な順位付けであり、確率や信頼度ではありません。
• status: no_suitable_route_found：確認した範囲内では適切なものが見つかりませんでした（checked.direct_probes を参照）。これは、経路が存在しない証拠ではありません。別のホストや提供元のオープンデータポータルなどを調べてください。「API は存在しない」と結論付けないでください。
• 必ず limitations を確認してください。たとえば、外部検索を利用できなかったか、候補の調査数が上限に達したかが記載されています。

1 回あたりの上限：直接の HTTP リクエストは最大 8 件、合計 12 秒、レスポンスは 1 MiB、外部検索リクエストは最大 1 件です。LLM による推論はありません。ホスト型ベータ版では現在、決定論的な探索のみを実行します（検索プロバイダーは設定されていません）。

アクセス方法：ホスト型 MCP https://fallback.factrail.online/mcp（Streamable HTTP）または HTTP ツールの経路、x402 による従量課金（各チャレンジに支払いネットワークと金額が記載されます。アカウントや API キーは不要です）。支払いなしで試すには、PAYMENT_MODE=disabled を設定してセルフホストしてください（ローカル開発を参照）。機械可読な概要： llms.txt。詳細：エージェントとともに Fallback を使用する。

Fallback は一般公開されています。現在のローンチと配布状況、製品名変更の影響監査、探索／配布の準備状況監査、テレメトリーと 30 日間の KPI 定義を参照してください。

error_route を使用する場面

HTTP、API、MCP、またはツールのリクエストが失敗し、安全な次のアクションが明確でない場合に使用します。提示された証拠を分類し、範囲を限定した再試行のガイダンスを返します。復旧方法がすでに明らかな場合や、タスクにより深いドメイン推論が必要な場合は使用しないでください。リクエストを実行したり、文書化されていない修正方法をでっち上げたりすることはありません。

要件

• 現行の Node.js LTS（スキャフォールド作成時は Node 24、サポート対象のエンジンは Node 22 以降）
• npm

ローカル開発

npm install
cp .env.example .env
npm run generate
npm run dev

サーバーは /、/healthz、/readyz、/catalog.json、/openapi.json、/llms.txt、/llms-full.txt、/skill.md、/.well-known/x402.json、/.well-known/mcp/server-card.json、および /mcp の Streamable HTTP MCP エンドポイントを公開します。HTTP と MCP の両方が、共有ランタイムのハンドラーレジストリを介してディスパッチされます。ローカル開発では PAYMENT_MODE=disabled を使用できます。有料のデプロイでは、test または production を明示的に選択し、x402 の設定をすべて指定する必要があります。

検証

npm test
npm run typecheck
npm run lint
npm run benchmark:source-route
npm run benchmark:error-route
npm run verify:catalog
npm run release:check

30 秒で開始

x402 対応のエージェントを https://fallback.factrail.online/mcp に接続し、具体的な失敗または検索の判断があった後に対応するツールを呼び出して、支払いチャレンジに表示されたネットワーク、トークン、受取先、金額のみを承認してください。HTTP クライアントは、ホストのオリジンで POST /v1/tools/{tool_id} を使用できます。例とスキーマについては、skill.md を参照してください。

アーキテクチャ

src/core/registry.ts が唯一の正式なツールレジストリです。すべてのディスカバリー機能と配布アーティファクトは、ここから生成されます。各ツールには src/tools/ 配下にディレクトリがあり、コントラクトとハンドラーが含まれます。今後追加するツールのテストとフィクスチャは、対応するコントラクトのテスト／フィクスチャ用ディレクトリに配置します。HTTP アダプターと MCP アダプターは、同じツールハンドラーを呼び出す必要があります。決済ミドルウェアとマーケットプレイス連携は、ツールのロジックの外部に置きます。

このサービスは、アカウントや API キーを必要とせず、呼び出しごとに x402 V2 決済をサポートします。サーバーが決済を受け取るのは X402_PAY_TO のみで、受け取り用ウォレットの秘密鍵は必要ありません。必要なネットワーク、受け取りアドレス、ファシリテーター URL、または本番 URL が不足しているか無効な場合、有料モードの起動は安全側に倒して失敗します。デプロイと決済の設定を参照してください。

例

{
  "goal": "Download the latest population dataset",
  "start_url": "https://ec.europa.eu/eurostat/",
  "preferred_formats": ["csv", "json"]
}

目標と start_url または domain のいずれかを指定して、POST /v1/tools/source_route を呼び出します。結果は確認済みの範囲に限定されます。結果が見つからなくても、そのルートが存在しないとは限りません。外部検索の認証情報がなくても、直接サイトを検索できます。Tavily または Brave が設定されており、直接検索だけでは不十分な場合、このツールは検索リクエストを最大 1 回行います。

PRODUCT、ARCHITECTURE、TOOL_ADMISSION、DISTRIBUTION、RELEASEを参照してください。

関連：FACTRAIL MCP

フォールバックの背景には、FACTRAIL MCPと同じ作者と設計原則があります。エージェントツールは、見つけた内容だけでなく、確認した内容も報告すべきです。FACTRAIL は、証拠の強さ、未解決の項目、受領証を含む証拠エンベロープを返すことで、「この事実について何が確立されており、どの情報源に基づくのか？」に答えます（「創作するより、分からないと伝えるほうがよい」）。フォールバックは「このデータはどこで入手できるのか？」に答えます（「存在しないことの証明にはならない」）。この 2 つはコード上の依存関係を持たない独立したサービスであり、どちらか一方だけでも利用できます。