生産性・ドキュメント

AirtableをAIエージェントに接続する

Airtableは業務データを保管する場所です。Atakoのエージェントはこれを一括更新し、クリーンアップし、変更を監視できます。トークンは選択したベースに限定されます。

Atakoのエージェントが執筆 · 確認・承認者 Romain Laodicina · Atako CTO

想定されるワークフロー

ベースの同期と一括更新

外部ソース(CSVエクスポート、フォーム、他のツール)からAirtableにデータを取り込む際、エージェントはget_base_schemaでベースのスキーマを読み取り、batch_create_recordsとbatch_update_recordsで10件単位のバッチとしてレコードを作成・更新します。マージ用フィールドを指定したupsertも可能です。エクスポートのたびに1行ずつインターフェースへ貼り付けたり、その場で生まれた重複を手作業で確認したりする必要がなくなります。

ベースの監査とクリーンアップ

エージェントはquery_recordsで数式によるフィルター(重複、空欄、古いステータスなど)をかけてテーブルを照会し、修正リストを作成したうえで、承認済みのレコードをbatch_delete_recordsで一括削除します。営業やHRの管理台帳を、四半期ごとにチームの誰かが手作業で行う整理なしに、使える状態のまま保てます。誰も本当には時間をかけて正しくこなせない反復作業です。

Webhookによる共有ベースの監視

エージェントはcreate_webhookで機微なベースにWebhookを登録し、list_webhook_payloadsで前回確認以降に蓄積した変更を定期的に確認します。レコードのステータスが変わるとすぐに反応でき、例えば別テーブルの関連レコードを更新したり、チームに知らせたりできます。特定の変更の発生を検知するためにベースを常時問い合わせ続ける必要はありません。

コネクタのアクション

  • list_bases

    読み取り。トークンがアクセスできるベースを一覧表示する。

  • get_base_schema

    読み取り。ベースのスキーマ(テーブル、フィールド、ビュー)を取得する。

  • list_records

    読み取り。テーブルのレコードを一覧表示する。ビューとページネーションに対応。

  • query_records

    読み取り。並べ替えと数式フィルターでテーブルを照会する。

  • get_record

    読み取り。識別子でレコードを1件取得する。

  • list_webhooks

    読み取り。ベースに登録されたWebhookを一覧表示する。

  • create_record

    書き込み。テーブルにレコードを作成する。

  • batch_create_records

    書き込み。1回の呼び出しで最大10件のレコードを作成する。

  • update_record

    書き込み。レコードの一部フィールドを更新する。

  • batch_update_records

    書き込み。最大10件のレコードを更新する。upsertも可能。

  • delete_record

    書き込み。識別子でレコードを1件削除する。

  • create_webhook

    書き込み。変更通知を受け取るためのWebhookを登録する。

前提条件

  • インテグレーションを接続するための、Atako企業アカウントの管理者権限。
  • 接続するベースへのアクセス権を持つAirtableアカウント。
  • airtable.comで作成し、必要なスコープを付与したPersonal access token。
  • トークン作成時に明示的に許可されたベース。

接続方法

  1. 1

    設定 → 連携を開く

    管理者が利用可能なコネクタの一覧からAirtableを選択する。

  2. 2

    Personal access tokenを作成する

    airtable.com/create/tokensで、トークンに名前を付け、スコープと許可するベースを追加する。

  3. 3

    トークンをAtakoに貼り付ける

    prefixがpatのトークンは、Airtable側で一度しか表示されないため、すぐにコピーする。

  4. 4

    エージェントにアクセス権を付与する

    エージェントごとに、読み取りのみ、または読み書きのスコープで、具体的なアクションを選択する。

自律型エージェントをAirtableに接続する理由

Airtableは、本格的なDBMSの制約を負うことなく、チーム全体のデータベースとして使われることがよくあります。しかし継続的な更新が必要な点は同じです。これはまさに人間が長期にわたって苦手とする作業です。毎週時間を割かない限り、誰もベースをきれいな状態に保ち続けられませんが、自律型エージェントは反復作業に飽きることなく継続的に稼働します。

これを可能にするのがツールコーリングという仕組みです。受け取った指示に応じて、エージェントはあらかじめ決められた手順に従うのではなく、スキーマを読み取るか、レコードの一括更新を行うか、変更を監視するかを自ら選びます。接続はairtable.comで作成するPersonal access tokenを通じて行われ、作成時に選んだ特定のベースとスコープに限定されます。

この継続的な仕組みは、複数のツールから同時に更新される真実の情報源としてベースを使う、データ運用レベニューオペレーション調達のエージェントに近い業務によく適合します。AirtableはAtakoのスタンダードプランに含まれるインテグレーションの一つで、他のコネクタと同じ扱いです。

制限とベストプラクティス

一括書き込み(batch_create_records、batch_update_records、batch_delete_records)は、Airtable側で1回の呼び出しにつき10件のレコードが上限で、種類を問わずベースごとに1秒あたり5リクエストに制限されています(AirtableのAPI制限)。1,000行を処理するエージェントは1回の呼び出しではなく約100回の呼び出しを行い、Airtableから429エラーが返された場合はペースを落とす必要があります。

トークンは、作成時に選択したベースにのみアクセスできます。エージェントを新しいベースに追加するには、Atako側のgrantを変更するだけでなく、airtable.comに戻ってトークンを拡張する必要があり、両プラットフォーム間の軽い連携作業が求められます。

replace_recordはレコード全体を置き換えます。呼び出しにリストされていないフィールドはすべて空になります。これに対しupdate_recordは指定したフィールドのみを変更します。既存レコードの一部のフィールドだけを変更したい場合は、update_recordを使用してください。

関連するユースケース

関連する連携機能

よくある質問

エージェントが誤ってレコードを削除することはありますか。

grantに書き込みスコープでdelete_recordまたはbatch_delete_recordsが含まれている場合のみ発生し得ます。多くのチームはこれらのアクションを専用エージェントに限定し、正確な指示とテストベースでの事前検証を行っています。

AtakoからAirtableへのアクセスをどう取り消しますか。

設定 → 連携から、Airtable接続のRevokeをクリックします。暗号化されたトークンは即座に削除され、それを使用していたすべてのエージェントは直ちにアクセスを失います。

トークンは自分のすべてのAirtableベースにアクセスできますか。

いいえ、airtable.comでのトークン作成時に明示的に選択したベースのみです。エージェントに新しいベースを追加するには、Atako側のgrantを変更するだけでなく、Airtable側でトークンの範囲を拡張する必要があります。

次に読む

出典

Romain Laodicina

Atako CTO

このコンテンツはAtakoのAIエージェントが執筆し、その後Atako CTOのRomain Laodicinaが確認・修正・承認しました。

最初のAIエージェントを導入

無料でアカウントを作成し、コード不要で数分でエージェントを起動できます。

AIの最前線を 常にキャッチアップ。

新機能、新しいエージェント、当社のAI分析を直接受信箱にお届けします。スパムなし、いつでも配信停止できます。