連携により、Atoms をすでにお使いのツールやサービスに接続できます。コネクタによっては、Atoms は構築を支援しながら外部情報を利用したり、公開済みアプリに機能を追加したり、またはその両方のワークフローをサポートしたりできます。

各コネクタは、それぞれ独自のアクションと権限に対応しています。接続済みコネクタに表示される機能と権限スコープを確認してください。未接続の場合、詳細パネルには説明と接続コントロールのみが表示されることがあります。

作業を完了できる最小権限のアカウントと権限スコープを使用してください。パスワード、アクセストークン、秘密キー、または無関係な機密データをプロンプトに貼り付けないでください。サービスに本番データや顧客データが含まれる場合は、機密性のないサンプルでテストし、書き込みを許可する前に正確な対象を確認してください。

表示されるコネクタとアクションは、アカウントやリリースによって異なる場合があります。現在利用可能なものを確認するには、Atoms で Connector カタログを開いてください。

接続で何を行うべきかを決める

サービスを接続する前に、どこで必要になるかを決めてください。

目的	例
構築中にエージェントへコンテキストを与える	ファイルを探す、タスクを要約する、Issue を確認する、またはプロジェクトデータをプロンプトで使う
エージェントに別のサービスでアクションを実行させる	タスクを作成する、レコードを更新する、スプレッドシートにデータを追加する、またはカレンダーイベントを作成する
公開済みアプリにサービスを追加する	アプリケーションデータを保存する、認証を処理する、支払いを処理する、またはアプリのワークフローを実行する

複数の目的に対応するコネクタもあります。接続する前に、コネクタの説明と要求される権限を確認してください。

連携を接続する

主な入り口として Settings → Connectors を開いてください。ダッシュボードから Connect your tools to Atoms を選択することもできます。

連携の接続または切断には、ワークスペースオーナーまたは承認された管理者のアクセスが必要な場合があります。オーナーまたは管理者でなく、コントロールが利用できない場合は、ワークスペースオーナーまたは承認された管理者に依頼してください。

ダッシュボードから

1. Atoms ダッシュボードを開きます。
2. Connect your tools to Atoms を選択します。
3. 使用したいコネクタを選びます。そのコネクタカードに表示される接続コントロールに従ってください。
4. そのコネクタに表示されるコントロールを使用します。汎用の詳細パネルが開いた場合は Connect を選択してください。プロバイダー固有の連携では、独自のセットアップまたは認可フローが開くことがあります。
5. 求められた場合は、外部サービスにサインインします。
6. アカウントと権限を確認し、接続を承認します。
7. Atoms に戻り、コネクタが接続済みとして表示されていることを確認します。使用したい Chat でコネクタピッカーを開き、その Chat 用にコネクタを有効にしてください。

接続済みの連携を使う

どのサービスを使うかをエージェントに伝え、正しい項目を特定できるだけの十分な詳細を含めてください。役立つ詳細には次のようなものがあります。

• プロジェクト、ワークスペース、リポジトリ、フォルダー、カレンダー、またはスプレッドシートの名前
• タスク名、Issue ID、ファイル名、またはレコード識別子
• 日付範囲、期限日、担当者、ステータス、または優先度
• Atoms に読み取らせたい、要約させたい、作成させたい、または更新させたい内容

たとえば次のように指定できます。

• 「自分に割り当てられている高優先度の Linear issue を要約して。」
• 「Drive でローンチブリーフを見つけて、未決定事項を一覧にして。」
• 「承認済みのこれらのリードをキャンペーンのスプレッドシートに追加して。」
• 「次の火曜日の午後3時にデザインレビューのカレンダーイベントを作成して。」

Atoms が使用できるのは、そのコネクタが対応しているアクションと、接続されたアカウントで利用可能なデータのみです。必要な機能やアクションがそのコネクタに表示されていない場合は、そこで止めて、対応していると決めつけないでください。

実行前に外部変更を確認する

コネクタとアクションが外部データの作成または更新に対応している場合、Atoms は実行前に確認を表示することがあります。

確認する内容:

• サービスと接続済みアカウント
• 対象のファイル、スプレッドシート、カレンダー、プロジェクト、またはレコード
• 作成または変更される情報
• 日付、時刻、受信者、またはその他の重要な値

Atoms が確認を表示した場合は、それを確認し、続行するには Confirm を選択し、外部サービスを変更せずに終了するにはキャンセルしてください。書き込みの可否はコネクタとアクションによって異なります。読み取り専用コネクタでは書き込みアクションは提供されません。

書き込み後は、再試行する前に外部サービスで結果を確認してください。対象や値が誤っている場合は、ワークフローを停止し、利用可能であればプロバイダー自身の履歴、元に戻す機能、または復旧ツールを使用してください。コネクタを切断すると今後の利用は停止しますが、すでに行われた変更は元に戻りません。

接続を管理する

Connector カタログを開き、接続済みサービスを選択して現在の状態を確認します。

コネクタの詳細パネルから、次のことができる場合があります。

• どのアカウントが接続されているかを確認する
• コネクタが対応するアクションと権限スコープを確認する
• 認可の期限が切れたときに再接続する
• サービスが対応している場合は、アクセスを更新または変更する
• Atoms からアカウントを切断する

Atoms で切断すると、その接続の今後の利用は停止します。一部のサービスでは、サービス側のアカウント設定またはセキュリティ設定から Atoms のアクセスを取り消す必要がある場合もあります。

ユースケース別の例

以下の表はユースケースごとの編集上のグループ分けであり、カタログカテゴリの一覧ではありません。現在利用可能なコネクタの一覧については、検索可能なカタログを使用してください。

カテゴリ	一般的な用途	例
開発	ソース管理、リポジトリ、Issue、配信ワークフロー	GitHub, Linear
バックエンドとデータ	データベース、認証、ストレージ、構造化データ	Supabase
決済	チェックアウト、請求、決済ワークフロー	Stripe
作業管理	タスク、プロジェクト、担当者、期限日	Asana, Todoist
ファイルとコンテンツ	外部ファイルを検索、読み取り、整理する	Box, Dropbox
分析とマーケティング	トラフィック、検索パフォーマンス、キャンペーン、レポート	Google Analytics 4, Google Search Console, Google Ads

コネクタの利用可否は時間とともに変化します。現在の一覧については Atoms のカタログを使用し、コネクタを開いて正確な機能を確認してください。

セットアップガイド

ご利用のサービスに対応するガイドを選択してください。

• GitHub を接続する
• Supabase を接続する
• GA4 を接続する
• Google Search Console を接続する
• Google Ads を接続する

接続の問題については、連携のトラブルシューティングを参照してください。