連携のトラブルシューティング

このページでは、Atoms における一般的な接続および認可の問題を扱います。サービス固有の設定、サポートされているアクション、またはアプリ内での構成については、まず Connect and Manage Integrations を参照し、使用するサービスのガイドを選択してください。

まず次の点を確認してください

1. 障害が発生している場所を確認してください。 エージェントが Chat でサービスを使用できないのか、それとも機能がアプリ内でのみ失敗するのかを確認します。Chat 用にサービスを接続しても、それだけでアプリが正しく構成されていることは確認できません。アプリ内のみで発生する障害については、Connect and Manage Integrations を参照してください。
2. 連携を開いてください。 プロジェクトの Chat で、メッセージ入力欄の横にあるオプションメニューを開き、Connectors → Add connectors を選択します。サービスを検索して選択してください。接続済みか、まだ Connect が表示されているかを確認します。一部のサービスでは独自の管理画面が開きます。
3. サービス自体でアクセスを確認してください。 接続しようとしていたアカウントで、対象のファイル、リポジトリ、カレンダー、プロパティ、またはその他のリソースを正確に開けることを確認してください。
4. 何かを変更する前にエラーを保存してください。 正確なメッセージ、日時とタイムゾーン、影響を受けるプロジェクトまたは Chat、最後に成功した試行を記録してください。スクリーンショットからは個人情報を伏せてください。

Chat の入力オプションを開き、Connectors (1)、次に Add connectors (2) を選択して、利用可能な連携を参照します。

利用可能な接続は Settings → Connectors でも管理できます。確認したい連携を選択してください。

認証情報は非公開にしてください。パスワード、ログインコード、API キー、アクセストークン、その他の秘密情報を Chat やサポート依頼に貼り付けないでください。認証情報は、サービスのサインインフローまたは指定された安全な設定フィールドにのみ入力してください。

問題を見つける

表示される内容	確認を始める場所
サービスが見つからない、またはそのコントロールが利用できない	連携を見つける、または開始する
サインインが開かない、ブロックされる、または完了しない	認可を完了する
接続が別のアカウントを使用している	接続されているアカウントを確認する
接続済みだが、エージェントがリソースを見つけられない	接続とデータアクセスを確認する
読み取りはできるが、作成または編集に失敗する	書き込みアクセスとサポートされているアクションを確認する
以前は動作していた接続が失敗する	何が変わったかを確認する
結果が古い、リクエストがタイムアウトする、またはエラーが繰り返される	リクエストとサービスの可用性を確認する

連携を見つけられない、または開始できない

1. Add connectors を使ってカタログを検索してください。Chat メニュー内の短い一覧は完全なカタログではありません。
2. Atoms にその機能はプロジェクト内でのみ利用可能と表示される場合は、対象のプロジェクトを開いてそこで試してください。
3. コントロールが無効になっている場合は、その説明を読んでください。別のロールまたは権限が必要な場合は、プロジェクトまたはワークスペースの所有者に支援を依頼してください。制限を回避するためだけに別のサービスを切断しないでください。

結果を確認してください: サービスの接続画面または管理画面を開けます。それでも表示されない場合は、Connect and Manage Integrations を確認するか、サポートに連絡して利用可能か確認してください。見つからないサービスがサインインを繰り返すことで有効になると考えないでください。

認可が完了しない

1. Connect を 1 回選択し、サービスのサインインウィンドウが表示されるか確認してください。ブラウザでポップアップがブロックされたと表示される場合は、Atoms サイトのポップアップを許可してから再試行してください。Chrome では、特定のサイトからのポップアップを許可する手順 に従ってください。すべてのサイトで有効にする必要はありません。
2. 対象のアカウントを選択し、要求されているアクセスを確認してください。ウィンドウを閉じる前に、サービスの認可フローを完了してください。
3. サービスが組織によってアプリまたは要求されたアクセスがブロックされていると明示している場合は、そのメッセージを保存し、管理者に連絡してください。組織のポリシーを回避しないでください。
4. Atoms に戻り、連携を再度開いて状態を確認してください。サインインウィンドウを閉じただけでは、認可が成功した確認にはなりません。

認可を完了する前に、要求されているアクセスを確認してください。アカウントを認可しても、それだけで対象のリソースが接続されていることは確認できません。

認可に組織またはワークスペースの選択が含まれる場合は、意図した選択になっていることを確認し、要求されている権限を確認してください。

結果を確認してください: 連携が接続済みとして表示されます。標準レイアウトを使用するコネクター詳細画面では、Connect が Disconnect と Try it out に置き換わります。その他のサービスには独自のレイアウトがあります。それでも Connect が表示される、またはエラーが表示される場合は、その結果を記録し、新たに 1 回試した後でサポートに連絡してください。

間違ったアカウントが接続されている

連携の管理画面にアカウントが表示される場合は、そのアカウントを、リソースを所有している、またはアクセスできるアカウントと比較してください。すべてのコネクターが接続中のアカウントを表示するわけではないため、ブラウザで現在サインインしている状態だけを、Atoms がどのアカウントを使用しているかの証拠として使わないでください。

対象のアカウントでサービス内のリソースを直接開いてください。そのアカウントでアクセスできない場合は、まずリソース所有者にアクセス権を依頼してください。接続が間違ったアカウントを使用している場合は、サービスのアカウント切り替え手順に従うか、安全に再接続する を実行し、認可時に正しいアカウントを明示的に選択してください。

結果を確認してください: 小さな、サポートされている読み取りリクエストで対象のリソースが返されます。それでもどのアカウントが接続されているか特定できない場合は、何度も切断するのではなくサポートに連絡してください。

連携は接続されているが、エージェントがデータを見つけられない

1. 接続を確認してください。 Connectors で連携の詳細を開き、接続済みであることを確認してください。表示されている場合は、選択されたアカウントまたはリソースも確認してください。
2. 正確なリソースを確認してください。 対象のアカウントでサービス内のリソースを直接開いてください。その場所とアクセス権限を確認し、該当する場合は正しい組織、ワークスペース、フォルダー、またはプロパティも確認してください。
3. リクエストを具体的にしてください。 コネクターが対応している場合は、サービス名を指定し、正確なリソース名またはリンクを提供してください。一度に複数のリソースを検索して変更するのではなく、まず 1 つのサポートされている読み取りアクションを依頼してください。

たとえば、コネクターがドキュメントの読み取りをサポートしている場合: “[service] を使って [document name or link] を読み取り、そのタイトルを教えてください。変更はしないでください。”

結果を確認してください: エージェントが対象のリソースを返します。直接アクセスはできるのにエージェントがまだ読み取れない場合は、コネクターのサポートされている機能と付与されたアクセスを確認してください。認可の問題を示す証拠がある場合にのみ再接続してください。

エージェントはデータを読めるが、変更できない

読み取りに成功しても、コネクターが要求された変更をサポートしていることや、その変更を行う権限があることは確認できません。

1. Connect and Manage Integrations または、表示されている場合はコネクターの What you can do 一覧を確認してください。要求されたアクションがサポートされていることを確認します。
2. 接続されているアカウントに、その正確なリソースに対してその変更を行う権限があるか確認してください。必要なアクセスのみを、リソース所有者または管理者に依頼してください。
3. エラーまたは確認リクエストを読んでください。追加の認可が必要な場合は、サービスの文書化されたフローに従ってください。再接続しても、コネクターがサポートしていないアクションを追加することはできません。

書き込みを再試行する前に: 最初の試行ですでに何かが作成または変更されていないか、送信先を確認してください。失敗した応答だけでは、変更が発生していない証拠にはなりません。前回の結果が分かるまでは、支払い、メッセージ、招待、またはレコード作成を繰り返さないでください。

結果を確認してください: サポートされている変更が適切なテスト用リソースで成功し、サービス内で直接確認できます。支払いやその他の本番ワークフローについては、実際の取引ではなく、サービス固有のテスト手順を使用してください。

以前は動作していた接続が停止した

最後に成功したリクエスト以降に何が変わったかを確認してください: アカウント、そのリソースへのアクセス、組織のアプリポリシー、または接続の認可です。

1. Atoms で連携を再度開き、まだ接続されているか確認してください。
2. サービス内でリソースを直接開いてみてください。アクセスが削除されている場合は、リソース所有者または管理者と解決してください。
3. エラーに認可の期限切れ、取り消し、または無効と表示される場合は、安全に再接続する に従ってください。エラーがサービス障害、制限、または未サポートのアクションに関するものであれば、まずその原因に対処してください。

結果を確認してください: 小さな読み取りリクエストが再び動作します。同じエラーが残る場合は、最後に成功した時刻とあわせて保存し、サポートに連絡してください。

結果が古い、またはリクエストが失敗し続ける

1. 結果をサービス自体と比較してください。該当する場合は、アカウント、リソース、日付範囲、フィルター、タイムゾーンを確認してください。会話内の以前の回答に頼るのではなく、現在の値を取得するようエージェントに依頼してください。
2. 明示的なタイムアウトまたはサービス利用不可エラーの場合は、サービスの公式ステータスページまたはヘルプページを確認してください。エラーに再試行時刻が示されている場合は、その時刻まで待ってください。制限または障害が続いている間は、リクエストを繰り返し送信しないでください。
3. 未送信のテキストを保存し、Atoms を更新して、コネクターの状態を再確認してください。ページの更新は、アカウントの再認可と同じではありません。
4. 小さな読み取りリクエストを 1 回再試行してください。外部データを変更するものを再試行する前に、以前の結果が送信先にあるか確認してください。

結果を確認してください: 新しい結果が、サービス内の対象リソースと一致します。引き続き正しくない場合は、期待される値と実際の値をタイムスタンプ付きでサポートに送ってください。すべての連携が同じスケジュールで更新されるとは考えないでください。

安全に再接続する

認可が無効な場合、または間違ったアカウントがリンクされている場合に再接続してください。失敗したすべてのリクエストに対する最初の手順として行わないでください。

切断する前に: 接続に依存するタスクを完了または一時停止し、保留中の外部書き込みの結果を確認し、必要なアクセス権で再度サインインできることを確認してください。切断すると、再接続されるまでその接続は利用できなくなります。追加の影響については Connect and Manage Integrations を確認してください。切断によって以前の変更が元に戻る、またはすでに送信された作業が取り消されるとは考えないでください。

1. サービスの接続詳細を開いてください。独自のアカウント管理画面がある場合は、その連携の手順に従ってください。
2. 標準のコネクター詳細画面では、準備ができたら Disconnect を選択し、その後 Connect を選択してください。切断前に追加の確認があるとは考えないでください。
3. 対象のアカウントを選択して認可を完了してください。要求されている権限を確認します。
4. Atoms に戻り、接続済みの状態を確認してください。
5. 元のタスクを再開する前に、以下の復旧確認を実行してください。

同じエラーが再び表示される場合は、再接続をやめて、エラー内容とすでに完了した確認事項を添えてサポートに連絡してください。

問題が解決したことを確認する

1. 直接確認できるリソースに対して、サポートされている読み取り専用アクションを 1 つ依頼してください。Try it out を使う場合は、送信前に提案されたプロンプトを確認してください。
2. 応答をサービス自体と比較してください。接続済みの表示だけでなく、正しいリソース、アカウントコンテキスト、要求した結果を確認してください。
3. タスクに変更が必要な場合は、適切なテスト用リソースまたはサービスで文書化されているテストワークフローを使用し、送信先で結果を確認してください。

接続状態と選択されたリソースを確認してください。接続済みの表示だけでは、期待するデータが利用可能であることや最新であることは確認できません。

組織とプロジェクトを確認し、その後 Dashboard を開いて変更を加えずにリソースを確認してください。切断はこの確認の一部ではありません。

この確認に問題がなければ、タスクを再開してください。Chat では動作するのにアプリ内の機能がまだ失敗する場合は、Connect and Manage Integrations または build and preview troubleshooting を参照してください。障害が発生している環境を確認してください。Chat でのリクエスト成功は、アプリが正しく構成されている証拠にはなりません。

サポートを受ける

問題が解決しない場合は、Get support を使用し、次の内容を含めてください。

• 連携名と、あなたの Atoms アカウントのメールアドレス。
• 影響を受けるプロジェクトまたは Chat のリンク、および障害が Chat で発生するのかアプリ内で発生するのか。アプリの場合は、影響を受ける環境を特定してください。
• 調査に必要な、秘密情報ではない識別子のみを使った、対象のサービスアカウントとリソース。
• 正確なエラー、日付、時刻、タイムゾーン。分かる場合は最後に成功した時刻も含めてください。
• 再現手順、期待される結果、実際の結果、すでに試した確認事項。
• ブラウザとデバイス、必要に応じて個人情報を伏せたスクリーンショットまたは短い録画。

書き込みの失敗については、送信先に変更完了が表示されているか、変更がないか、または結果が不明かを記載してください。すべての添付ファイルから、パスワード、ログインコード、API キー、トークン、および無関係な個人情報を削除してください。