この記事を使ってデータコネクターのログを読み解き、コネクターエラーの原因を特定し、適切な解決策を講じてください。この記事は少なくとも1つのデータコネクターを設定したチームメイト向けで、なぜ失敗しているのかを診断するためのものです。
データコネクターのログへのアクセス方法
データコネクターのログは、コネクターが行ったすべてのリクエストの履歴を表示します。コネクターのログを開くには、設定 > 統合 > データコネクターに移動し、コネクターを選択してからログタブを開きます。
特定の会話のログを見つける方法
特定の会話中にどのデータコネクターが実行されたか（および失敗したかどうか）を確認するには、Inboxで会話を開き、会話タイムラインからイベント履歴ビューを有効にします。失敗したデータコネクターの実行は赤で強調表示されます。
ログの読み方
ログエリアには主に3つのコンポーネントがあります。リスト内の任意のリクエストを選択すると、その詳細パネルが開きます。
フィルター: ログを異なる値や期間でフィルターできます。
リクエスト一覧: 各エントリーは日時、コネクターをトリガーしたもの、リクエストが成功したか失敗したかを表示します。
リクエスト詳細: リクエストが通過した各段階の内訳と、どの段階で失敗したかを示します。
フィルター
日付範囲ピッカーを使って特定の期間でログをフィルターしてください。
以下のいずれかの値でもフィルターできます。
実行ID: 各コネクターリクエストの一意の識別子です。問題診断時にサポートチームがこれを求めることがあります。
会話ID
ステータス（成功／失敗）
失敗タイプ：
リクエスト設定エラー: コネクターの設定が誤っているため、例えばURLや必須フィールドが欠落または間違っていて、Finは呼び出しすら試みられませんでした。
Faradayエラー: ネットワークレベルの接続エラーで、Finは外部サービスに全く到達できませんでした。通常はタイムアウト、DNS障害、サーバーが到達不能で発生します。外部サービスがオンラインか、コネクターのURLが正しいか確認してください。
3rd party API (application programming interface) エラー: Finは外部サービスに正常に到達しましたが、サービスがエラーを返しました。例えばリクエストが拒否されたか、一時的に利用不可でした。外部サービス提供者に連絡し、エラー応答を共有して調査を依頼してください。
レスポンスマッピングエラー: 外部サービスは正常に応答しましたが、Finは期待された方法で応答からデータを読み取れませんでした。
トークン更新エラー: 外部サービス認証に使われるOAuth（Open Authorization）トークンの有効期限が切れ、自動更新が失敗しました。コネクター設定の再認証ボタンを使ってアクセスを復元してください。
リクエスト検証エラー: Finが送信しようとしたデータが無効または不完全と判定され、リクエストが実行されませんでした。
コードブロック変換エラー: コネクターがデータ送信前または受信後に再フォーマットするために使うカスタムコードスニペットがクラッシュしたか、予期しない結果を出しました。
実行場所:
Fin: コネクターはFin AIが顧客との会話を処理中にトリガーされました。
Procedure: コネクターはProcedure（Finがステップごとに従う構造化されたタスクやワークフロー）によってトリガーされました。
Inbox: コネクターはチームメイトがInboxの会話から直接手動でトリガーしました。
Inbox Automation Rule: コネクターはInbox内の特定条件が満たされたときに実行されるよう設定されたルールによって自動的にトリガーされました。
Custom Bot: コネクターはWorkflowsビルダーで作成されたボットフローによって会話を自動化するためにトリガーされました。
Resolution Bot: コネクターは古いResolution Botが顧客の質問に自動回答しようとした際にトリガーされました。
Macros (Saved Reply): コネクターはチームメイトが会話で保存済み返信（macro）を使ったときにトリガーされました。
リクエスト詳細
リストからリクエストを選択すると詳細パネルが開きます。以下の4つのセクションはデータコネクター実行の各段階をカバーします。
実行
リクエスト
レスポンス
レスポンス処理
4つのセクションはデータコネクターリクエストの異なるフェーズを表しています。
実行はリクエストの開始から終了までのライフサイクル全体をカバーします。何がデータコネクターをトリガーしたかを示します。例えばFin AI Agent、Procedure、またはInboxのチームメイトなどです。
リクエストはFinが外部システムに送信する内容です。ここでエラーがあればリクエストは送信されていません。通常はURL、リクエストペイロード、またはコネクター設定の問題が原因です。原因が不明な場合は実行ログの詳細を添えてサポートに連絡してください。
レスポンスは外部システムがFinに返す内容です。ステータスコード200は成功を示します。5XX（500や502など）は外部システムのサーバー側エラーを示し、エラー応答を外部サービス提供者に共有して調査を依頼してください。4XXはクライアント側エラーで、404はリクエストされたリソースが見つからないこと、401や403は認証または認可の問題を示します。一般的に4XXエラーは無効、不完全、または権限のないデータが送信されたことを意味します。
レスポンス処理はFinがデータコネクター設定で構成したレスポンスマッピングを適用する段階です。このステップが失敗すると、APIレスポンスの構造がコネクターの期待と異なることが多いです。レスポンスマッピングを設定で確認し、問題が続く場合はログの詳細を添えてサポートに連絡してください。
なぜデータコネクターは成功するのにFinは何も見つけられないと言うのか？
データコネクターは200ステータスコードで正常に実行されても、Fin AI Agentが何も見つけられないと言うことがあります。これは通常、APIレスポンスのペイロードが大きすぎるか、Finが関連データを抽出できないほど構造化されていない場合に起こります。解決策としては、Finが必要とする特定のフィールドのみを返すようAPIレスポンスを最適化し、完全なデータオブジェクトを送信しないことです。レスポンスサイズを減らしても問題が続く場合はサポートに連絡してください。
ヒント: Procedure内で実行されるデータコネクター特有の問題については、Fin ProceduresとData connectorsのトラブルシューティングを参照してください。