AIツール接続ガイド

AIツールの接続トラブル解決

ページが開かない、ログイン後に機能が使えない、回答が途中で止まる。それぞれ何を確認すればよいのでしょうか。最初に失敗した箇所を特定してから、回線、権限、利用枠を確認しましょう。

クライアントのインストールやサブスクリプションの追加がまだの場合は、使い方ガイドに沿って接続を確認してください。接続済みなのに特定のAIツールが使えない場合は、以下の目次から該当する項目をご覧ください。VPNI6は国際回線を提供しています。各サードパーティーツールの利用可否は、提供元の地域ポリシー、アカウント権限、サービスの稼働状況によって異なります。

AIツールの利用可否を確認

「使えない」を再現可能な症状にする

調査を始める前に、最後に成功した操作と、その直後に失敗した操作を書き留めましょう。たとえば、製品のトップページは表示されるが、ログインを押すと認証プロバイダーの画面で止まる。あるいは、ワークスペースには入れるものの、短いプロンプトを送ると待機中のままになる、といった具合です。「インターネットにはつながる」だけでは原因を絞れません。ブラウザーのキャッシュからトップページが表示されても、実際のリクエストは別のドメインに送られる場合があります。エラーの原文、発生した時間帯、利用した入口を記録しておくと、次回のテストと比較できます。

個人情報を含まない短いプロンプトで、基本的なリクエストを確認します。たとえば、あいさつ文を一文生成するよう依頼します。最初はファイルのアップロード、検索、ツール呼び出し、画像生成を使わず、基本機能が動作したら、元の利用方法に合わせて機能を一つずつ追加します。テキストには回答できるのに添付ファイルのアップロードだけ失敗する場合は、アップロード先、ファイル形式、権限を確認しましょう。添付ファイル、長いプロンプト、モデル切り替えを同時に試すと、原因を特定しにくくなります。

地域、アカウント、通信経路は別々に確認する

利用地域の確認は、出口IPの所在地を調べるだけでは不十分です。サードパーティーのサービスは、製品の入口、アカウントの登録地域、支払い情報、組織での利用範囲などを個別に確認する場合があります。判断基準は提供元の公式案内を確認してください。また、IPアドレスの位置情報は、サービスごとに更新時期が異なることがあります。検索結果で分かるのは「リクエストがどこから送信されたように見えるか」であり、「そのアカウントに製品を利用する資格があるか」ではありません。公式ルールで利用対象外とされている場合は、利用可能なサービスに切り替えるか、提供元に確認してください。出口を何度も切り替えても資格の確認にはなりません。

認証の確認は、パスワードを入力するときだけではありません。ログインページ、認証プロバイダー、ログイン結果を受け取るアプリには、それぞれ別のセッションがあります。認証の前半は社内ネットワークを使い、アプリに戻るときに別の回線へ切り替わると、リダイレクトのループや再認証が発生することがあります。利用が許可されたネットワークで出口を統一し、製品の入口から最初からやり直してください。古いタブに表示されたコールバックURLを、新しい環境に繰り返し貼り付けないでください。

通信の確認では、リクエストが届くか、応答が最後まで返るかを調べます。DNSの名前解決エラー、証明書の検証エラー、サービスからの明示的な拒否、応答本文の途中切れは、それぞれ発生する段階が異なります。画面上では同じ「エラー」に見えても、対処方法は同じではありません。明確な応答がある場合は、まずエラー本文を確認します。応答がない場合は、接続がどの段階まで進んだかを確認しましょう。エラーを消すために証明書の検証を無効にしないでください。特に業務端末では、管理者に証明書チェーンを確認してもらいましょう。

再テストのたびに比較条件を記録する

まず提供元の稼働状況に関するお知らせを確認し、同じ製品、機能、地域に影響が出ていないか調べます。お知らせがなくても、サービスが完全に正常とは限りません。局所的な障害はまだ公表されていない場合があります。次に、同じアカウント、タスク、入口を使い、条件を一つだけ変更して試します。たとえば、回線はそのままブラウザーだけを変え、その後、元のブラウザーに戻して比較します。これにより、ブラウザーのセッションとネットワーク経路を切り分けられます。端末を変える場合は、ネットワークも変わったかどうかを記録してください。

結果は「接続前」「ログイン後」「送信後」「出力中」に分けて記録すると便利です。特定のワークスペースだけで失敗する場合は、まず権限や組織のポリシーを確認します。複数の端末で同じ入口への接続に失敗する場合は、共通のゲートウェイや出口を調べましょう。トップページにアクセスできても、特定のリソース用ドメインに問題がないとは限りませんが、調査範囲を絞る手掛かりにはなります。調査後は「回線を変えたら直った」で済ませず、再現に必要な条件を記録してください。

AIツールごとの入口の違い

製品を確認してから利用する入口を確認する

同じブランドでも、チャット画面、APIプラットフォーム、デスクトップアプリ、組織向けワークスペースが分かれている場合があります。名前が似ていても、同じ利用条件とは限りません。案内を確認する際は、個人アカウントと仕事用アカウントのどちらを使っているか、Web版、エディタープラグイン、開発者コンソールのどれを開いているかを確認してください。特に、地域の対象リストが利用中の入口にも適用されるか、提供元のヘルプセンターで確認しましょう。古いスクリーンショットだけで判断しないでください。

利用中の入口に応じて条件を確認
ツールまず確認する点優先して確認する項目最小限の確認方法
ChatGPTチャットWeb版とAPIプラットフォームワークスペース、プロジェクト、それぞれの利用条件テキストを送信し、APIは別途テスト
Claudeチャット製品と開発者向け入口利用中の製品の地域案内と認証情報の適用範囲現在の入口から短いテキストを送信
Gemini個人向け入口、開発ツール、組織環境選択中のアカウント、組織のポリシー、プロジェクト設定アカウントを確認し、テキスト機能を個別にテスト
Copilot業務用とコード連携の製品実際にログインしているアカウントと割り当てられた利用権限対象のアプリで基本機能を実行
Midjourneyタスクの送信と結果の読み込み利用中の入口の権限、タスクの状態、リソースへのリクエスト通常のテキストを送信して結果を確認
Cursorエディターのプロセスとターミナルのプロセスエディターのログイン状態、ネットワーク設定、機能の権限空のプロジェクトでチャットをテスト

ログイン成功はAPI呼び出しの成功を意味しない

ChatGPTとClaudeでは、Web版のセッションと開発者向け認証情報を別々に確認する必要があります。Web版にモデル一覧が表示されても、現在のセッションで一覧を取得できることを示すだけです。特定のプロジェクトで同じモデルをAPIから呼び出せるとは限りません。APIでエラーが出たら、ベースURL、プロジェクト、利用モデルが同じ製品環境に属しているかを確認してください。Web版が正常でも、それはあくまで比較用です。APIのリトライ回数を増やしたり、Web版のセッション情報をAPI認証の代わりに使ったりしないでください。

Geminiは個人向けと管理対象の環境で、利用できる機能が異なる場合があります。ブラウザーで複数のアカウントを使っていると、アプリで開かれたアカウントが、別のタブで選択したものと異なることがあります。アプリ内に表示されたアカウントと所属組織を確認し、管理者がその機能を許可しているか確かめてください。業務で使う場合、個人アカウントに切り替えて別の画面が表示されても、組織のデータを扱う代わりにはなりません。許可された入口を管理者に確認しましょう。

Copilotは、製品の正式名称を確認することが特に重要です。業務アプリ内の入口と、エディターに組み込まれたGitHub Copilotは、同じライセンスとして扱わないでください。コードエディターでは、ブラウザーでログインできても、正しいエディターのインスタンスに認証が戻ったとは限りません。拡張機能の状態、エディターで使用中のアカウント、組織での権限割り当てを確認します。複数のウィンドウで認証画面が開いた場合は、関係のないウィンドウを閉じ、問題が発生したウィンドウからやり直すと、認証情報の戻り先を確認しやすくなります。

タスクの状態と画面表示を切り分ける

Midjourneyでは、送信、キュー待ち、生成、結果の読み込みはそれぞれ別の段階です。画面上でタスク完了となっているのに画像が表示されない場合は、リソースへのリクエストと端末のコンテンツフィルターを確認し、同じタスクを再送しないでください。タスクが受け付けられない場合は、入口、アカウントの状態、エラーメッセージを確認します。公式サポートに問い合わせる場合はタスクIDを控え、プロンプトの原文や未公開の素材を公開の場に貼り付けないようにしてください。

Cursorでは、空のプロジェクトを使って問題を切り分けられます。まずログインと通常のチャットを確認し、ファイルコンテキスト、インデックス、拡張機能、リモート開発環境を一つずつ追加します。特定のワークスペースだけで失敗する場合は、グローバルなネットワーク設定を変更する前に、ワークスペースの上書き設定、組織のポリシー、リクエストの規模を確認してください。チャットは動くのにエディター内のターミナルからのリクエストが失敗する場合、ターミナルにエディターと同じプロキシ設定が引き継がれていない可能性があります。逆の場合も同様です。

問い合わせには「どの入口で、どの操作が失敗したか」を明記してください。Web版にはログインできるのに組織のプロジェクトが使えない場合は、組織の権限を確認事項として記載します。送信は成功したのに結果を読み込めない場合は、タスクの状態とリソースのエラーをあわせて記録しましょう。空白の画面を貼るだけよりも役立ち、ある機能が使えることを製品全体のすべての機能が使えると誤解するのも防げます。

国際回線とルーティングモード

エラーが発生した段階から回線を選び、名前だけで判断しない

回線を比較する前に、アカウントと利用地域が対象サービスのルールに適合しているか確認し、その用途で利用可能な経路を選びます。VPNI6は110+か国 / 210+回線に対応しています。地域と回線タイプはグローバルノードページで確認できます。回線名は候補を絞る参考にはなりますが、サードパーティーのサービスが特定の出口をどう判定するかは分かりません。対象地域で利用する場合も、トップページの表示速度だけでなく、同じタスク全体の動作を比較してください。

経路の種類に応じて比較テストを行う
回線タイプ比較するポイントテスト方法
IEPL専用線国際区間の変化と長時間の応答との関連応答本文が最後まで途切れずに届くか記録
中継中継経路を変えると接続状況が変わるか同じログイン入口と同じタスクで再テスト
直結追加の中継を使わない場合の動作基本的なリクエストの比較用経路として使う

回答の冒頭はすぐ表示されるのに、途中で頻繁に止まる場合は、受信が継続するかを比較しましょう。最初の文字が表示される速さだけでは不十分です。認証ページも開けない場合は、まずDNSと証明書を確認し、必要に応じて回線を切り替えます。経路上の一時的な遅延で長いリクエストが失敗することもありますが、ブラウザーのスリープ、ゲートウェイの読み取りタイムアウト、サーバー側の処理終了でも同じ症状が起こり得ます。回線の変更後に成功しても、条件をそろえて再テストしてください。

ルールモードではリクエスト経路全体を確認する

ルールモードを使っている場合は、クライアントの接続ログでアプリに適用されたルールを確認します。製品のトップページだけでなく、ログイン時の認証リダイレクトや、チャットと添付ファイルで異なるサービスアドレスが使われる場合があります。まず、最初に失敗したリクエストの種類を特定し、公式情報や組織で承認されたルールに沿って設定を補います。表示されたドメインをすべて広範囲のルールに追加すると、ほかの通信にも影響し、次回の原因調査が難しくなるため避けてください。

グローバルモードは、条件を限定した短時間の比較テストに利用できます。ただし、クライアントが実際に処理する通信だけが対象です。業務端末に管理ポリシーがある場合は、テストが許可されているか事前に確認してください。グローバルモードではログインできるのに、ルールモードに戻すとリダイレクトに失敗する場合は、認証入口とコールバックが異なる経路を通っていないか確認します。両方のモードで同じ権限エラーが返る場合は、ルーティングの変更をやめ、アカウントとサービスの利用条件を確認しましょう。

自動回線選択やスマートルーティングは日常の操作を減らすのに便利ですが、原因調査では変数になる場合があります。セッション中に経路が変わる設定では、障害の直前に選択されていた回線名だけでは実際の出口を特定しにくくなります。許可された範囲内で同じ候補回線に固定し、ログインとテストを行ってから通常の設定に戻しましょう。用語に不慣れな場合は、サブスクリプション、ノード、ルーティング用語の解説をご覧ください。

出口の確認で分かるのは、確認したプロセスの状態だけ

問題が発生しているブラウザーで本サイトのIPアドレス確認を開くと、そのページから見た出口が想定どおりか確認できます。ただし、ルーティングは宛先ごとに異なる場合があり、AIへのリクエストも同じ経路を通るとは限りません。ターミナル、エディター、リモートマシンの経路を示すものでもありません。対象プロセスの接続ログもあわせて確認してください。業務環境で管理対象のプロキシを使用している場合は、組織のネットワークルールを優先します。複数のコンポーネントが同時にシステムプロキシを変更すると、確認結果が食い違うおそれがあります。

テスト後は、再現可能な最小限の設定を記録します。使用した端末、モード、入口、操作内容を明記してください。問題の解決に必要なルールだけを残し、比較用に使ったグローバル設定は常用しないでください。夜間にエラーが増える場合は、できるだけ近い時間帯に同じタスクを再実行し、端末のネットワーク切り替え、サービスのお知らせ、出力が途中で切れたかどうかも記録します。回線を比較しながら、特定の時間帯の混雑を端末の設定のせいにすることを防げます。

アカウントの作成、ログイン、地域の確認

VPNI6のアカウントとサードパーティーのアカウントを分ける

VPNI6はメールアドレス不要で、ユーザー名とパスワードだけでアカウントを作成できます。このアカウントは本サービスのユーザーパネル用であり、サードパーティーのツールのアカウント、認証、支払いとは別です。サードパーティーのアカウントを作成する前に、現在の利用地域、アカウントの種類、利用したい機能が対象か確認してください。登録情報には正確な情報を入力し、提供元が案内するアカウント用ページから操作してください。利用可能な公式入口がない場合は、ポリシーを確認するか、利用条件に合った別の製品を選びましょう。

勤務先や学校から割り当てられたアカウントを使う場合は、個人でアカウントを作成してよいか、機能の権限を誰が割り当てるか確認してください。ログインできても選択した機能を利用できない場合は、別のディレクトリで認証している、組織を誤って選択している、管理者が権限を割り当てていないなどの原因が考えられます。同じアカウントで何度も作成し直しても条件は変わりません。画面に表示されるワークスペースを確認し、管理者に権限の割り当て記録を照合してもらうと、複数のアカウントを何度も切り替えるより原因を特定しやすくなります。

リダイレクトが止まった場所から原因を絞る

認証プロバイダーの画面に移る前に止まる場合は、URLが公式の入口か、ページが完全に読み込まれているか、管理対象ネットワークにアクセス制限がないか確認します。認証ページでは成功と表示されるのにアプリに戻ると再度ログインを求められる場合は、同じブラウザープロファイルと同じ操作元のウィンドウで認証を完了したか確認してください。サイトデータの設定、拡張機能、組織のポリシーがリダイレクトに影響することがあります。承認済みのクリーンな設定で比較し、全体のセキュリティ設定を無効にして試さないでください。

サイトデータを消去する前に、未送信の内容を保存し、アカウントの復旧手段が利用できることを確認します。問題に関連するサイトのデータだけを対象にし、作業環境全体を消去しないでください。デスクトップアプリがブラウザー認証を使う場合は、認証後にリクエストを開始したプロセスへ戻っていることを確認します。同じアカウントに複数の端末からログインしていても、ブラウザーが別の端末へ自動で認証を渡すことはありません。リダイレクト後はアプリ内のアカウントを確認してから、実際の機能をテストしてください。

ブラウザーでは正常にログインできてもアプリで再ログインを求められる場合は、端末の時刻、自動タイムゾーン設定、証明書の信頼状態を確認します。認証情報には有効期限があり、時計のずれがローカルでの判定に影響することがあります。証明書エラーの場合は、組織のルールに従ってシステムの信頼チェーンを確認してください。どちらもログイン時に起きる可能性がありますが、アカウントを替えても解決しません。不審な証明書の警告や、公式に似ていても異なるログインURLが表示された場合は、認証情報を入力せず、入口が信頼できるか確認してください。

追加認証、地域の対象外、アカウント停止を区別する

追加認証を求められたら、提供元、認証システム、社内ゲートウェイのどこから表示されたメッセージか確認します。公式の認証手順がある場合は、それに従ってください。端末やネットワークを頻繁に変えると、原因を再現しにくくなることがあります。地域や組織の利用資格が対象外と明示されている場合は、公式ルールに従い、出口の切り替えを繰り返さないでください。アカウントの制限や停止が表示された場合は、公式通知と最近の利用状況を確認し、公式窓口から異議申し立てや復旧を行います。

見慣れないアクティビティの警告が表示されたら、最近の認証とセッションを確認します。必要に応じて不審なセッションを終了し、提供元の案内に従って認証情報を変更してください。コールバックURL全体、ブラウザーのセッション情報、スクリーンショットに含まれる認証情報を非公式のサポート担当者に渡さないでください。調査に必要なのは、失敗した段階と表示された内容であり、再利用可能なログイン情報ではありません。スクリーンショットを共有する前に、アカウントを特定できる情報、ワークスペース名、非公開のタブを隠してください。

アカウントを復旧したら、信頼できる端末で一連の操作を確認します。元のワークスペースに入れることを確認し、業務データを含まない短いプロンプトを送り、以前失敗した機能をテストしてください。ログインが復旧しても特定の機能が使えない場合は、その機能のエラーを個別に記録し、ログイン問題として扱わないようにします。無意味な認証の繰り返しを減らし、引き継ぎ先が適切な権限の確認から始められます。

Web版、API、ストリーミング出力

ページが開いても、確認できたのは一部のリクエストだけ

ブラウザーでページを開くとキャッシュが使われる場合があります。プロンプトを送信したときに、初めてバックエンドへの新しいリクエストが発生することもあります。クライアントはモデル一覧の取得、添付ファイルのアップロード、生成結果の取得を個別に行う場合があります。過去の履歴は表示されるのに新しい内容を生成できない場合は、開発者ツールのネットワークパネルで、新たに発生した失敗リクエストを特定し、主なエラーの種類を確認します。比較テストには公開しても問題のないテキストだけを使ってください。ネットワークログには、リクエストの原文や応答全体が含まれる場合があります。

APIはプロジェクトの認証情報を使って認証します。呼び出し側は、URLとモデルの選択、有効なパラメーターの送信、応答の読み取り、処理の完了判定も行う必要があります。Web版が正常でも、プロジェクト権限、未対応のパラメーター、請求設定の未完了などによりAPIが失敗することがあります。まず公式ドキュメントに従って最小限のリクエストを作成し、添付ファイル、ツール呼び出し、構造化出力は使わずに確認します。基本のリクエストが成功してから、必要なパラメーターを個別に有効にしてください。

最初の応答までの時間と、応答中の待ち時間を分けて確認

ストリーミング出力は、生成中の内容を複数回に分けて返します。最初のデータがなかなか届かない場合、接続がまだ確立していない、サーバー側で生成が始まっていない、経由するゲートウェイが応答をバッファリングしているなどの可能性があります。本文の受信開始後に止まる場合は、プロキシのアイドルタイムアウト、読み取り側の早期終了、サーバー側での処理未完了などが考えられます。調査では、応答ヘッダーを受信したか、本文が順次届いたか、仕様に定められた終了イベントを受信したかをそれぞれ記録してください。

サービスがServer-Sent Eventsを使っている場合、ネットワークから読み取った一まとまりのデータが、完全なイベント一つに対応するとは限りません。一つのイベントが複数回の読み取りに分割されたり、一つのデータブロックに複数のイベントが含まれたりします。パーサーはプロトコル上のイベント境界に沿って内容を処理し、次のデータブロックにまたがる未完成のデータも保持する必要があります。ネットワークを変えた後に分割のされ方が変わると、回線障害に見えても実際は読み取りプログラムが原因かもしれません。提供元が保守するAPIクライアントと、そのイベント処理方法を優先して利用してください。

一度に変更する条件は一つだけ
確認項目切り分ける内容比較方法
接続タイムアウトリクエストに必要な接続を確立できるか同じプロセスから許可されたテスト用URLにアクセス
読み取りタイムアウト接続後、応答データを待つ時間の上限クライアントとゲートウェイの読み取り制限を確認
全体の制限時間タスク全体で待機できる時間実行環境とアプリ独自の制限時間を比較
出力の上限パラメーターによって正常終了しているか終了理由を読み取り、通信の切断と区別

短いリクエストが非ストリーミングでは成功し、同じタスクがストリーミングでは失敗する場合は、ストリーム処理、ゲートウェイのバッファリング、応答のアイドル時間を確認します。反対に、非ストリーミングでは全内容が届くまで応答が返らず、長いタスクが全体の制限時間に達することがあります。すべての制限時間を一律に延ばすのではなく、まずテストを短くし、どの段階で制限に達するか確認してから、通常の処理量に適した値を設定しましょう。

リクエストを再実行する前に、すでに起きたことを確認する

ユーザーによるキャンセル、一部の出力を受信した状態、サービス側の処理失敗を、すべて「未実行」と記録してはいけません。通信が切断されても、サーバー側では呼び出しを受信して処理を続けている場合や、結果の一部を生成済みの場合があります。書き込み、公開、課金が伴うタスクをむやみに再送しないでください。まずタスクの状態を確認し、提供元が冪等リクエストに対応しているか確かめます。確認できない場合は、一部の結果を保存して未完了と記録し、再実行するかどうかを呼び出し側で判断してください。

大きな添付ファイルやリッチメディアを使ったタスクだけでエラーが起きる場合は、添付ファイルの数やコンテキストの長さを減らし、アップロードの未完了、処理の失敗、結果のダウンロード失敗を切り分けます。機密情報を含まない同種のサンプルで再現を試し、元のファイルをサポート窓口に公開しないでください。空の会話が安定して動くか、添付ファイルを使うとどこで止まるか、結果が生成済みかなど、比較できる結果を記録しましょう。未整理のブラウザーログを大量にコピーするより役立ちます。

CLI、IDE、CIのネットワーク設定

まず実際にリクエストを送信しているプロセスを確認

ターミナルのコマンドは現在のターミナル環境から実行され、デスクトップエディターはシステム画面から起動される場合があります。リモート開発の拡張機能は別のマシン上で動作することもあります。それぞれが同じシステムプロキシ、環境変数、証明書ストアを使うとは限りません。調査は「どのプロセスがリクエストを送っているか」の確認から始めます。まず実際にコマンドを実行する場所でテストし、拡張機能やアプリの診断画面で実行場所を確認してください。ローカルのブラウザーの出口から、リモートの実行環境も同じ経路を使っていると推測しないでください。

コマンドラインでは、組織で許可された一般的なHTTPSのURLに、認証情報や業務データを含めずにアクセスします。次の例は、公開されているサンプルサイトへのリクエストを行い、各段階の所要時間を出力します。現在のコマンドから一般的なサイトにアクセスできるかを確認するもので、サードパーティーのAIサービスの稼働確認ではありません。プロキシを使っている場合、接続時間にプロキシまでの接続が反映されることがあります。対象サービスまでのエンドツーエンドの遅延として扱わないでください。

curl --silent --show-error --output /dev/null \
  --write-out 'http=%{http_code} dns=%{time_namelookup} connect=%{time_connect} first=%{time_starttransfer}\n' \
  https://example.com/

システム環境とアプリの両方が、組織で承認されたプロキシ設定に対応している場合は、単一のコマンドだけで設定を変更してテストできます。次の例は対応するターミナルで使えます。APPROVED_PROXY_URLが管理環境で設定済みの場合に限り、2つ目のコマンドを実行してください。実際の設定値をリポジトリに書き込んだり、チケットに貼り付けたりしないでください。前のテストと比較する際は、既存の除外ルールによって対象のURLが別の経路を通っていないかも確認します。

test -n "$APPROVED_PROXY_URL" && \
  HTTPS_PROXY="$APPROVED_PROXY_URL" \
  curl --silent --show-error --head https://example.com/

一般的なURLにアクセスできる場合は、利用中の製品について、公式ドキュメントが案内する診断方法を確認します。プロキシ環境変数の扱い、大文字と小文字の区別、システム設定の参照方法はプログラムごとに異なります。一つのコマンドで成功しても、すべてのツールで使えるとは限りません。組織のゲートウェイが管理対象の証明書を要求する場合は、管理者の案内に従って該当する証明書チェーンをインポートしてください。証明書検証を無効にするオプションは使わないでください。証明書エラーの種類を記録し、環境変数の全内容や証明書ファイルを公開の添付資料に含めないようにします。

エディターでは拡張機能の実行場所がローカルかリモートか確認する

エディター内のWebビュー、拡張機能のホスト、統合ターミナルでは、それぞれ異なるネットワーク設定が使われる場合があります。まず拡張機能がどこで動作しているか確認し、ユーザー設定、ワークスペース設定、リモート設定のどれが適用されているかを調べます。変更後はアプリの手順に従って該当プロセスを再読み込みし、空のワークスペースで通常のリクエストを一つ試してからプロジェクトを開きます。特定のリポジトリだけで失敗する場合は、グローバル設定を何度も変更せず、プロジェクトごとの上書き設定や組織のポリシーを確認してください。

CIでは実際の実行ノードから接続を確認する

CI環境からの接続は、コードをコミットした端末ではなく、実行ノードから行われます。ホスト型またはセルフホスト型の実行ノードが、提供元の地域要件と組織の外部接続ポリシーを守っているか確認してから、管理者が許可された接続先と送信経路を設定します。プラットフォームのシークレット管理機能を使い、認証情報は必要なプロジェクトと権限のあるタスクだけに限定してください。信頼できない変更から実行されたタスクに認証情報を渡さず、ログから実行環境の情報が自動出力されないようにします。

一般的な接続確認、最小限のAPI呼び出し、業務タスクをそれぞれ独立してテストし、失敗時には終了した段階を報告します。各タスクに全体の制限時間を設定し、同時実行数とリトライを制限して、同じ種類のタスクに適切なスケジュールを適用します。定期的な一括実行でだけ失敗する場合は、多数のタスクが同時に開始されたか、同じ利用枠を取り合っていないか確認してください。役立つビルドレポートには、機密情報を除いた状態、段階、タスクIDを記載し、リクエストヘッダー全体は出力しないでください。

ローカルでは成功し、パイプラインで失敗する場合は、環境変数の引き継ぎ、証明書の設定、選択中のプロジェクト、実行ノードの外部接続ルールを比較します。ネットワーク設定を変更しても、すぐに本番デプロイを再実行せず、本番データを含まない診断タスクで先に確認してください。テストの成功後に通常のワークフローへ戻し、設定は管理されたデプロイドキュメントに記録します。一時的なテスト変数を恒常的な設定と誤解されないようにしてください。

レート制限、リスク判定、アカウント停止

リトライを決める前に拒否理由を読む

サービスから明確な応答が返った場合、少なくとも応答を返せる段階まではリクエストが届いています。ただし、その応答元は対象アプリではなく、企業ゲートウェイの可能性もあります。エラー本文、関連する応答ヘッダー、公式案内を確認し、認証情報の無効、権限不足、利用枠の超過、短時間のリクエスト過多、上流サービスの障害を切り分けます。画面に「しばらくしてから再試行してください」と表示されただけで回線を切り替えたり、すべてのエラーに同じリトライ方法を適用したりしないでください。

短時間の制限は、呼び出し頻度、同時実行数、入力や出力の規模に関係する場合があります。総量や残高の上限に達した場合は、利用枠の更新を待つか、管理者による対応が必要です。同じプロジェクト内のバックグラウンド処理と対話型リクエストの両方を調査対象に含めてください。画面上で一度しか操作していなくても、複数の自動タスクが同時にリクエストを送信している可能性があります。不要なタスクを一時停止し、プロジェクトの利用状況と制限範囲を確認してから再開を判断しましょう。

サービスがRetry-Afterを返した場合は、その指示に従って待機し、待ち時間もタスク全体の制限時間に含めます。待機時間の指定がなく、公式にリトライが認められている一時的なエラーでは、待機時間を段階的に延ばし、ランダムなずれを加えると、多数のタスクが同時に再実行されるのを防げます。リトライの上限を設定し、予算を超えたら呼び出し元にエラーを返してください。認証情報や権限のエラーは原因を先に修正し、リトライで自然に解決することを期待しないでください。

重複しやすいリクエストを抑える

リクエストが急増した原因を調べるときは、ユーザー操作が複数回実行されていないか、クライアントとゲートウェイの両方で自動リトライが行われていないか、タイムアウト後に同じタスクを再送していないか確認します。リトライは一つのレイヤーで一元管理し、明確な拒否を受け取ったら下流の処理がさらに負荷をかけないようにしましょう。タスクキューで同時処理数を制限し、同じ操作には関連IDを付けて、すでに受け付けられていないか確認します。

長時間のタスクでは、不要な会話履歴や重複アップロードを減らしましょう。許可された場合は、機密情報を含まない再利用可能な静的結果をキャッシュし、同じ問い合わせを複数のタスクから同時に送らないようにします。継続的な業務利用が必要な場合は、提供元が認める利用枠の申請やプラン変更を利用してください。制限を避けるためにアカウントを増やしたり、出口を切り替えたり、認証情報を共有したりしないでください。接続回線とサードパーティーAPIの利用枠は別のものです。

アカウント制限には確認と異議申し立ての手順を利用する

不審なログイン、追加認証、アカウント停止が表示された場合は、自動リトライを止め、その通知が本当にサービス提供元から送られたものか確認します。不審なアクセスは、認証情報の共有、意図しない自動リクエスト、登録情報の不一致、利用規約に反する使い方などと関連する可能性がありますが、エラーの見た目だけで原因は特定できません。公式通知で情報の追加提出を求められた場合は、指定された方法で対応してください。新しいアカウントを使って、停止された活動を続けないでください。

認証情報が漏えいした疑いがある場合は、関連タスクを直ちに停止し、提供元の手順に従って認証情報を失効または更新します。リポジトリの履歴、ビルドログなど、情報が残っている可能性のある場所を確認してください。公式サポートには、機密情報を除いた時間帯、リクエストID、利用した入口を伝えます。セッションを直接復元できる情報は提出しないでください。チーム環境ではプロジェクト管理者にも連絡し、同じ異常に対して対応が競合しないようにします。

復旧後は制限が解除されたか確認し、同時実行数を抑えた小さなタスクでテストします。同じ拒否が続く場合は、呼び出し量を増やして何度も確認せず、状況を引き続き記録してください。一時的なエラーだけをリトライする、提供元の待機指示に従う、権限に変更があればキューを停止するなど、実行可能な変更をタスク設定に反映します。制限の再発を防ぐには、利用状況を隠すのではなく、タスクの動作を制御し、ルールに従うことが大切です。

接続の確認、再チェック、問題の引き継ぎ

端末を問わず使える確認記録を作成する

日常の確認では、入口、アカウント、タスク、結果の順にチェックできます。利用が許可された製品の入口にアクセスし、現在のアカウントまたはワークスペースを確認します。機密情報を含まない短いリクエストを送り、出力が最後まで届くことを確かめてから、必要な添付ファイル、ストリーミング、エディターの機能をテストしてください。単にチェックを付けるのではなく、「何を確認できたか」を記録します。たとえば、ログイン後のプロジェクトが正しいか、ストリーミングの終了イベントを受信したか、テキスト以外の結果を読み込めたかなどです。

別の端末で再テストする場合は、テスト内容を変えず、端末のネットワークとルーティングモードを個別に記録してください。VPNI6はWindows / macOS / iOS / Android / Linuxに対応し、同時接続台数に制限はありません。これは本サービスのクライアントと端末の対応範囲であり、サードパーティーのアカウントでも同じ利用方法が許可されることを意味しません。共有の業務環境では、各自が許可されたアカウントを使用し、比較テストのために個人の認証情報を交換しないでください。

クライアントをまだインストールしていない場合は、使い方ガイドに沿ってユーザーパネルにログインし、サブスクリプションを取得してから接続を確認します。接続済みでも経路による差が大きい場合は、グローバルノードページで候補の回線を確認し、このガイドのルーティング手順で比較してください。VPNI6のサブスクリプションの通信量や期間に関する問題は、プランページで料金と通信量の条件を確認します。本サービスのサブスクリプション状況と、外部AIプラットフォームのAPI利用枠を混同しないでください。

症状に応じて適切な窓口に相談する

同じ端末から複数の接続先にアクセスできない場合は、VPNI6への問い合わせに、プラットフォーム、選択した回線タイプ、モード、発生した時間帯、試した比較方法を記載してください。社内の入口やプラグインだけで問題が発生する場合は、管理者に権限、ゲートウェイ、管理対象証明書を確認してもらいます。特定のAIプラットフォームだけがアカウントや利用枠のエラーを返す場合は、そのプラットフォームに問い合わせ、確認可能なリクエストIDを添えてください。本サービスの問い合わせ窓口にサードパーティーの権限変更を依頼しないでください。

スクリーンショットやログは、共有前に機密情報を取り除いてください。エラーの原文、実行した操作、表示された状態、再現の安定性を記録すれば十分です。サブスクリプションURL全体、API認証情報、セッションデータ、非公開の文書、顧客のプロンプトは添付しないでください。内部コードに関する問題は、最小限のサンプルで再現を試します。実際のプロジェクトでしか発生しない場合は、組織のデータ取り扱いルールに沿って問い合わせ先を選び、再現のためにワークスペース全体を無断でアップロードしないでください。

修正後は同じ操作を再実行する

対応案を受け取ったら、まず内容が明確な基準状態に戻してから、案にある変更を一つずつ適用します。変更後は記録した中で最短の失敗操作を実行し、元のワークフローも確認してください。元の障害が長時間の出力や一括処理に依存する場合は、短いプロンプトが成功しただけでは不十分です。許可された範囲で処理量を徐々に戻し、同じ段階でエラーが起きるか観察します。別の箇所で新しい問題が起きた場合は、元の記録を上書きせず、別に記録してください。

短時間の比較テストが終わったら、不要な一時ルール、デバッグ出力、テスト用認証情報を削除します。チームで長期的に共有するのは、承認済みの設定と確認手順であり、特定の端末で偶然成功した設定のスクリーンショットではありません。提供元の地域や権限に関する要件が変更された場合は、関連ドキュメントを更新し、提供元に確認すべきケースとローカル環境を調べるケースを共有してください。実際に確認した日時を記録すると、古い結果を現在も有効な保証と誤解せずに済みます。

リモートで共同作業する場合は、同僚が実際に利用する入口で確認します。チャットWeb版が開けることを、ビデオ会議やファイル共有の動作確認の代わりにしないでください。業務によってパケットロスや遅延の影響は異なるため、リモートワーク向け回線の選び方を参考に、用途ごとの確認手順を作成できます。本サービスの接続問題について問い合わせる場合は、ユーザーパネルからチケットを送信し、最初に失敗したときの状況と直近の再テスト結果をそれぞれ記載してください。