すべてのCloudプランで利用できます。セルフホストではBusinessプラン以上が必要です。
- 接続：Teableに許可したサードパーティーのアカウント。Slack、Airtable、Google Sheetsなど。
- シークレット：自分で保存する文字列。APIキーやアクセストークンなど。
接続とシークレットを管理する
左下のアバターをクリックし、設定 → 統合を開きます。ページは自分の接続、自分のシークレット、許可したサードパーティアプリの3つに分かれています。
sk_test_で始まるキーを入力します。アプリの権限付与をこのアカウントに切り替えれば、アプリのコードを変更する必要はありません。
同じサービスに複数のアカウントを接続できます。たとえば、仕事用と個人用の2つのGmailアカウントです。自分の接続はサービスごとにまとめられ、グループ名の横にアカウント数が表示されます。接続済みのサービスは新しいアカウントを接続の一覧に表示されなくなるため、別のアカウントを追加するには、そのサービスのグループでアカウントを追加をクリックします。各アカウントはそのサービスでのメールアドレスまたはユーザー名で表示され、アプリやオートメーションへ付与するときもこの名前で選択します。同じアカウントをもう一度認可すると、行が増えるのではなく既存の接続が更新されます。サービスから識別できる名前が返されない場合は、アカウントのメニューで名前変更をクリックし、区別しやすい名前を付けられます。
認可の期限が切れたアカウントには再接続が必要と表示されます。アカウントのメニューで再接続をクリックします。
各認証情報の下にはN 個のリソースで使用中と表示され、続いて最大3つのアプリやオートメーションのタグが並びます。タグをクリックすると、そのリソースが新しいタブで開きます。残りは**+Nにまとめられ、クリックすると使用されている場所の一覧が開き、各項目に付与した日時が表示されます。リソースにこの認証情報を使わせたくない場合は、タグまたは一覧の項目にある ×（認可を解除）をクリックして確定します。そのリソースには未バインド**のプレースホルダーが残ります。
アプリやオートメーションへ付与する
リソースの認証情報パネルを開きます。- アプリ：App Builderのチャットパネルで**+** → もっと → 認証情報と設定。
- オートメーション：ワークフローを開き、ワークフローを編集タブで認証情報と設定をクリック。
リソースの付与を変更するには、そのアプリやオートメーションの編集権限が必要です。付与できるのは自分の認証情報だけです。
コードから読み取る
オートメーションの入力欄にキーらしき文字列を貼り付けると、Teableはそれを自分のシークレットとして保存し、その場には参照だけを残します。平文がワークフローの設定に残ることはありません。貼り付けたままにしたい場合は、通知の元に戻すをクリックします。
サードパーティアプリ呼び出しのクレジット
接続を介してサードパーティアプリを呼び出すと、スペースのクレジットを消費します。AI チャット、アプリ、オートメーションのいずれからの呼び出しでも計上され、請求ページの クレジット使用量 に種別 サードパーティアプリ として表示されます。 ほとんどのアプリは 1 回あたりの消費がごくわずかです。X のように返却件数やリクエスト単位で Teable に課金するアプリは、1 回の呼び出しでも消費が目立って大きくなります。失敗した呼び出しは課金されず、利用できるツールの検索も課金されません。スペースのクレジットが尽きると、これらの呼び出しは拒否されます。AIチャットでの認可カード
AIが外部アカウントを必要とする場合、このタスクには認証が必要です と書かれたカードが会話に固定され、対応するまでそのターンは先に進みません。カードは、その認証情報を誰が使うかによって2種類あります。 接続カード：Gmailからメールを取得する、Notionに書き込むなど、Cuppy自身がサービスを読み書きしてタスクを終える必要があるときに表示されます。カードにはサービス名が示され、接続 を押すとOAuthを実行するか、そのサービスのキーを入力します。接続が完了するとそのターンが再開し、接続は 設定 → 統合 の 自分の接続 に保存されます。Teableが自ら連携しているサービスも、Composioが管理するサービスも、このカードから接続できるので、先に設定画面を開く必要はありません。スキップ を押すと接続せず、AIはそれに依存しない部分の処理を続けます。接続に失敗した場合はカードにエラーが表示されるので、再試行 でもう一度接続するか、中止 でこのリクエストを終了します。
- … を接続：そのサービスのアカウントをまだ接続していないときに表示されます。OAuthを実行し、新しい接続はそのリソースへ自動的に付与されます。キーで接続するサービスでは**… のキーを入力**と表示されます。
- 入力欄と保存して認可：そのエイリアスのシークレットをまだ持っていないときに表示されます。入力した値は自分のシークレットとして保存され、そのリソースへ付与されます。
- 認可ボタン：すでに持っている接続やシークレットをそのまま付与します。エイリアスがすでに別の認証情報で使われている場合は、新しい変数名で自分の認証情報を追加するボタンに変わります。自分の認証情報に置き換えるよう依頼した場合は、置き換えるボタンに変わります。
- … のを使う：エイリアスに他のメンバーの認証情報がバインドされているときに表示され、その認証情報をそのまま使います。
- スキップ：認証情報を渡しません。AIはそれに依存しない部分の処理を続けます。