連携を接続して管理する
連携により、Atoms をすでに使用しているツールやサービスに接続できます。コネクタによっては、Atoms は構築を支援しながら外部情報を利用したり、公開済みアプリに機能を追加したり、またはその両方のワークフローをサポートしたりできます。
各コネクタは、それぞれ独自のアクションと権限に対応しています。接続済みコネクタに表示される機能と権限スコープを確認してください。未接続の場合、詳細パネルには説明と接続コントロールのみが表示されることがあります。
ジョブを完了できる最小権限のアカウントと権限スコープを使用してください。パスワード、アクセストークン、秘密鍵、または無関係な機密データをプロンプトに貼り付けないでください。サービスに本番データや顧客データが含まれる場合は、書き込みを許可する前に、機密性のないサンプルでテストし、正確な対象を確認してください。
表示されるコネクタとアクションは、アカウントやリリースによって異なる場合があります。現在利用可能なものを確認するには、Atoms でコネクタカタログを開いてください。
接続で何を行うべきかを決める
サービスを接続する前に、どこでそれが必要かを決めてください。
| 目的 | 例 |
|---|---|
| 構築中にエージェントへコンテキストを与える | ファイルを見つける、タスクを要約する、問題を確認する、またはプロジェクトデータをプロンプトで使う |
| エージェントが別のサービスでアクションを実行できるようにする | タスクを作成する、レコードを更新する、スプレッドシートデータを追加する、またはカレンダーイベントを作成する |
| 公開済みアプリにサービスを追加する | アプリケーションデータを保存する、認証を処理する、支払いを処理する、またはアプリのワークフローを実行する |
一部のコネクタは複数の目的に対応しています。接続する前に、コネクタの説明と要求される権限を確認してください。
連携を接続する
主要な入口として Settings → Connectors を開いてください。ダッシュボードから Connect your tools to Atoms を選択することもできます。
連携の接続または切断には、ワークスペース所有者または承認された管理者のアクセスが必要な場合があります。所有者または管理者でなく、コントロールが利用できない場合は、ワークスペース所有者または承認された管理者に依頼してください。
ダッシュボードから
- Atoms ダッシュボードを開きます。
- Connect your tools to Atoms を選択します。
- 使用したいコネクタを選びます。そのコネクタカードに表示される接続コントロールに従ってください。
- そのコネクタに表示されるコントロールを使用します。汎用の詳細パネルが開いた場合は Connect を選択してください。プロバイダー固有の連携では、独自のセットアップまたは認可フローが開くことがあります。
- 求められた場合は、外部サービスにサインインします。
- アカウントと権限を確認し、接続を承認します。
- Atoms に戻り、コネクタが接続済みとして表示されていることを確認します。使用したい Chat でコネクタピッカーを開き、その Chat に対してコネクタを有効にしてください。
接続済みの連携を使う
どのサービスを使うかをエージェントに伝え、正しい項目を特定できるだけの十分な詳細を含めてください。役立つ詳細には次のようなものがあります。
- プロジェクト、ワークスペース、リポジトリ、フォルダー、カレンダー、またはスプレッドシートの名前
- タスク名、問題 ID、ファイル名、またはレコード識別子
- 日付範囲、期限日、担当者、ステータス、または優先度
- Atoms に読み取らせたい、要約させたい、作成させたい、または更新させたい内容
たとえば:
- 「自分に割り当てられている優先度の高い Linear の問題を要約して。」
- 「Drive でローンチ概要を見つけて、未解決の決定事項を一覧にして。」
- 「承認済みのこれらのリードをキャンペーンのスプレッドシートに追加して。」
- 「来週火曜日の午後3時にデザインレビューのカレンダーイベントを作成して。」
Atoms が使用できるのは、そのコネクタが対応しているアクションと、接続されたアカウントで利用可能なデータのみです。必要な機能やアクションがそのコネクタに表示されていない場合は、そこで止めて、対応していると決めつけないでください。
実行前に外部変更を確認する
コネクタとアクションが外部データの作成または更新に対応している場合、Atoms は実行前に確認を表示することがあります。
確認する内容:
- サービスと接続済みアカウント
- 対象のファイル、スプレッドシート、カレンダー、プロジェクト、またはレコード
- 作成または変更される情報
- 日付、時刻、受信者、またはその他の重要な値
Atoms が確認を表示した場合は、それを確認し、続行するには Confirm を選択し、外部サービスを変更せずに終了するにはキャンセルしてください。書き込みの可否はコネクタとアクションによって異なります。読み取り専用のコネクタでは書き込みアクションは提供されません。
書き込み後は、再試行する前に外部サービスで結果を確認してください。対象または値が誤っている場合は、ワークフローを停止し、利用可能であればプロバイダー自身の履歴、取り消し、または復旧ツールを使用してください。コネクタを切断すると今後の利用は停止しますが、すでに行われた変更が元に戻るわけではありません。
接続を管理する
コネクタカタログを開き、接続済みサービスを選択して現在のステータスを確認します。
コネクタの詳細パネルから、次のことができる場合があります。
- どのアカウントが接続されているかを確認する
- コネクタが対応しているアクションと権限スコープを確認する
- 認可の期限が切れたときに再接続する
- サービスが対応している場合にアクセスを更新または変更する
- Atoms からアカウントを切断する
Atoms で切断すると、その接続の今後の利用は停止します。一部のサービスでは、サービス側のアカウント設定またはセキュリティ設定で Atoms のアクセスを取り消す必要がある場合もあります。
ユースケース別の例
以下の表はユースケースごとの編集上のグループ分けであり、カタログカテゴリの一覧ではありません。現在利用可能なコネクタの一覧については、検索可能なカタログを使用してください。
| Category | Common uses | Examples |
|---|---|---|
| 開発 | ソース管理、リポジトリ、問題、デリバリーワークフロー | GitHub, Linear |
| バックエンドとデータ | データベース、認証、ストレージ、構造化データ | Supabase |
| 支払い | チェックアウト、請求、支払いワークフロー | Stripe |
| 作業管理 | タスク、プロジェクト、担当者、期限日 | Asana, Todoist |
| ファイルとコンテンツ | 外部ファイルの検索、読み取り、整理 | Box, Dropbox |
| 分析とマーケティング | トラフィック、検索パフォーマンス、キャンペーン、レポート | Google Analytics 4, Google Search Console, Google Ads |
コネクタの提供状況は時間とともに変化します。現在の一覧については Atoms のカタログを使用し、コネクタを開いて正確な機能を確認してください。
セットアップガイド
サービスに対応するガイドを選択してください。
接続の問題については、連携のトラブルシューティング を参照してください。