トラブルシュート
Troubleshooting
Signal Foundry 利用時の典型エラーと、次に打つべき手をまとめます。
このページの内容3項目
Signal Foundry の失敗は、ほとんどが次の 7 種類に収まります。
company_not_found- auth 系の
401 - 接続先や access model を外した
404 - レート制限の
429 needs_human- credit / preview / export の境界違反
- source import / feedback / billing の設定不足
CLI を使う場合は、まず次を徹底してください。
sf --help sf version --json --check-update sf auth show --json sf data capabilities --json sf companies search --help
--json を付けると、失敗時に次の key が返ります。
error.codeerror.messageerror.hinterror.suggested_next_commands
つまり、Claude Code や Codex から使う場合は、エラー文を読むだけでなく、返ってきた次コマンド候補をそのまま実行させるのが正解です。
このカテゴリでは、失敗の種類ごとに復旧手順を固定します。
よくある復旧ルート
| 状況 | まず見るもの | 次にやること |
|---|---|---|
| CLI が古い / command がない | sf version --json --check-update | npm install -g @signal-foundry/cli@latest と sf agent install --target codex --force |
| 自然文検索が 0 件 | sf list plan "<query>" --json | weak_conditions / unsupported_conditions を見て、observations search --source edinet か代替条件に戻る |
needs_human | plan.conditions | silent 0件にせず、足りない条件をユーザーに確認する |
max_credits_required / max_credits_exceeded | credit と maxCredits の失敗 | estimate の必要 credit と --max-credits を揃える |
credit_balance_insufficient | credit と maxCredits の失敗 / sf credits balance --json | Free / Pro / Credit Pack / campaign grant の残高を確認してから再実行 |
estimate_not_found / preview_export_not_allowed | estimate と materialize の失敗 | estimate から作り直すか、saved List にしてから export |
multiple_candidates | sf source inspect / sf source map | 法人番号、domain、ticker など identifier column を増やして resolve し直す |
feedback_not_configured | feedback inbox | 利用者側では直せないため、時間を置いて再送するか support に連絡する |
| checkout できない | checkout / portal | plan、支払い方法、ブラウザのブロック設定を確認し、解決しなければ support に連絡する |
credit まわり
実行前に estimate を見ます。
sf list estimate "上場企業のうち、売上100億以上" --json sf list materialize --from-estimate <estimateId> --execute --max-credits 100 --json sf list enrich <listId> --source website --estimate --json sf list enrich <listId> --source website --execute --max-credits 100 --json sf credits balance --json
not_found no_data error skipped は enrichment credit を消費しません。found になった row だけが enrichment credit 対象です。 materialize の失敗は credit と maxCredits の失敗 と estimate と materialize の失敗 に分けて復旧してください。
source import まわり
CSV はまず置いて、headers と mapping を確認します。import / inspect / map は無料です。
sf source import ./companies.csv --name "展示会リード" --json sf source inspect <sourceId> --json sf source map <sourceId> --entity company --column name=会社名 --column domain=URL --json sf source resolve <sourceId> --execute --max-credits 100 --json sf source review <sourceId> --status multiple_candidates --json sf source select <sourceId> --row <sourceRowId> --company <companyId> --max-credits 1 --json
resolve で multiple_candidates が出た場合は、agent が勝手に確定せず source review で候補を確認します。ユーザーが明示した候補だけ source select で matched にできます。候補が弱い場合は、company name だけでなく法人番号や domain を足してください。not_found は偽装して埋めず、source 側の resolution evidence として残します。