トラブルシュート
トラブルシュート
Signal Foundry 利用時の典型エラーと、次に打つべき手をまとめます。
このページの内容3項目
Signal Foundry の失敗は、ほとんどが次の 6 種類に収まります。
company_not_found- auth 系の
401 - 接続先や access model を外した
404 - レート制限の
429 needs_human- usage / credit の境界違反
- feedback inbox / billing の実行失敗
CLI を使う場合は、まず次を徹底してください。
sf --help --json sf version --json --check-update sf auth show --json sf search --help --json sf company --help --json sf credits summary --help --json
--json を付けると、失敗時に次の key が返ります。
error.codeerror.messageerror.hinterror.suggested_next_commands
つまり、Claude Code や Codex から使う場合は、エラー文を読むだけでなく、返ってきた次コマンド候補をそのまま実行させるのが正解です。
このカテゴリでは、失敗の種類ごとに復旧手順を固定します。
よくある復旧ルート
| 状況 | まず見るもの | 次にやること |
|---|---|---|
| CLI が古い / command がない | sf version --json --check-update | Homebrew または winget で sf を更新し、sf agent install --target codex --force --json。最新 version が catalog 反映待ちの場合だけ GitHub Release artifact を使う |
| 自然文検索が 0 件 | sf search "<query>" --json | gaps[]、source_context、meta を見て、短い条件に直す |
needs_human | gaps[] | silent 0件にせず、足りない条件をユーザーに確認する |
max_credits_required / max_credits_exceeded | クレジットと maxCredits の失敗 | 対象会社数、signal、上限を揃える |
credit_balance_insufficient | クレジットと maxCredits の失敗 / sf credits balance --json | Free / Pro / Credit Pack / campaign 付与の残高を確認してから再実行 |
feedback_inbox_write_failed | feedback inbox | durable inbox に保存できていないため、重複投稿を避けて support に連絡する。Canny 連携未設定だけなら通常は queued になる |
| checkout できない | checkout / portal | plan、支払い方法、ブラウザのブロック設定を確認し、解決しなければ support に連絡する |
クレジットまわり
繰り返し検索や深い signals の前に usage とクレジットを見ます。
sf query --file company-query.json --json sf credits balance --json sf credits summary --json
財務しきい値は company_query.v1 に構造化してから sf query で実行します。Free は探索、Paid は volume と深い signals のために使います。クレジット失敗は クレジットと maxCredits の失敗 で復旧してください。
ローカルリストまわり
ユーザーがCSVや表を求める場合は、sf search のJSONから agent 側で local file を作ります。
sf search "<criteria>" --limit 20 --json
会社が曖昧な場合は、法人番号、domain、ticker のどれかで再検索します。