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

連携が接続できない、動作しなくなった、またはタスクを完了できない場合は、このガイドを使って接続、アカウントアクセス、選択したリソースを確認してください。

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

認可を完了する前に、要求されているアクセスを確認してください。アカウントを認可したことだけでは、意図したリソースが接続されている確認にはなりません。

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

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

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

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

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

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

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

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

たとえば、コネクターがドキュメントの読み取りに対応している場合: “Use [service] to read [document name or link] and tell me its title. Do not change it.”

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

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

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

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 キー、トークン、および無関係な個人情報を削除してください。