Flutter の家計シミュレーションアプリに Claude を用いたAIコメント機能を「任意設計」で組み込んだ実装記録

Salesforce Apex から Claude API を呼び出す際、Named Credential + External Credential でカスタムヘッダー経由に x-api-key を設定しても 401 エラーが続いた。根本原因は Named Credential の `allowMergeFieldsInHeader` が false に設定されており、ヘッダー内のマージフィールド式 `{!$Credential.Anthropic.ApiKey}` が評価されていなかったこと。true に変更することで解決。

著者は Microsoft Copilot で複数アクションの会議予約に失敗したが、同じタスクを Claude Opus で試すと成功した経験から、Microsoft が低リテラシーユーザー向けに意図的に制限を強めていると分析。AI リテラシーの差によって同じ LLM でも計画（プランニング）が変わることを実例で示し、ユーザー教育と資格制度によるアドバンスドモード構想を提案している。

OpenAI 互換の AI API ルーター導入時、base URL とキー管理だけでなく、model catalog の検証、endpoint family の区別、streaming タイムアウト、各種ツール連携など見落としやすい運用項目がある。チームに導入する前に curl、SDK、利用可能 model、ログを同じ表で検証すると事故を減らせる。

論文「Don't Retrieve, Navigate」に基づく Corpus2Skill は、RAG の検索ベース手法を階層的ツリーナビゲーションに置き換える。コンパイル段階で埋め込みを使用してコーパスを可視化し、サーブ時はツリー探索とバックトラックで文書を特定することで、検索漏れと視界の狭さを解決し、プロンプトキャッシュとの相性により実測で 48% のコスト削減を実現する。