エージェントがユーザーの接続したアプリで動く
ユーザーは Shopify や Gmail など 1,600+ のアプリを一度接続するだけです。エージェントは今お使いの AIsa キーと残高でそのアカウントのアクションを実行し、OAuth トークンを保存する必要はありません。
1 回のリクエストでユーザーのアカウントのアクションを実行
アクション、エンドユーザー、入力を指定します。AIsa がそのユーザーの Connection を選び、アクションの schema で入力を検証してから、アプリの結果を返します。
本番環境で検証済みのアプリ 15 件
例 · 架空の店舗 store_8812
エンドユーザーごとに専用の Connection
Connection は AIsa アカウントと 1 つの externalUserId に属するため、あるユーザーの実行がほかのユーザーのアカウントに触れることはありません。
成功した実行だけに課金
成功した実行は 1 回 $0.0003 で、どのプランでも同じです。失敗した実行、アプリの閲覧、接続、Connection の管理は無料です。
ユーザーが接続できるアプリ
それらのアプリのアクション
成功した実行 1,000 回あたり
閲覧・接続・管理
アプリごとに省ける連携作業
ユーザーが接続するアプリごとに、本来は OAuth アプリ、トークンの保管、API クライアント、エラー処理が必要ですが、AIsa Connect は 1 つの API と AIsa キーでそのすべてを引き受けます。
| アプリごとの作業 | 自前で作る場合 | AIsa Connect の場合 |
|---|---|---|
| サインイン | プラットフォームに OAuth アプリを登録する | AIsa がホストするページでユーザーがサインイン |
| 認証情報 | 全ユーザーのトークンとキーを保管・保護する | AIsa が保管し、手元にはユーザー ID だけ |
| API クライアント | アプリごとに作り、保守する | 1 回のリクエストでどのアクションも実行 |
| 入力チェック | API ごとに手書きする | すべてのアクションが schema を公開 |
| ユーザーごとのアクセス | 自分のコードで担保する | 各 Connection は 1 人のユーザーに属する |
| エラー | API ごとに形式が違う | 対処する側を示す共通の形式 |
- サインイン
- 自前で作る場合
プラットフォームに OAuth アプリを登録する - AIsa Connect の場合
AIsa がホストするページでユーザーがサインイン - 認証情報
- 自前で作る場合
全ユーザーのトークンとキーを保管・保護する - AIsa Connect の場合
AIsa が保管し、手元にはユーザー ID だけ - API クライアント
- 自前で作る場合
アプリごとに作り、保守する - AIsa Connect の場合
1 回のリクエストでどのアクションも実行 - 入力チェック
- 自前で作る場合
API ごとに手書きする - AIsa Connect の場合
すべてのアクションが schema を公開 - ユーザーごとのアクセス
- 自前で作る場合
自分のコードで担保する - AIsa Connect の場合
各 Connection は 1 人のユーザーに属する - エラー
- 自前で作る場合
API ごとに形式が違う - AIsa Connect の場合
対処する側を示す共通の形式
カタログから結果まで 3 つのリクエスト
アクションと schema を調べ、ユーザーにアプリを接続してもらい、AIsa キーでそのユーザーのアクションを実行します。
- 1
アクションを探す
アプリのアクションを検索し、それぞれの入力 schema と、読み取り・書き込み・削除のどれかを確認します。
GET /apps/shopify/actions?q=order - 2
ユーザーがアプリを接続
OAuth アプリは AIsa がホストするページへ送ります。キーで接続するアプリは、Shopify のトークンとストアドメインなど必要な項目を転送します。
POST /connect/shopify/credentials - 3
そのユーザーのために実行
アクションキー、ユーザーの externalUserId、入力を送ります。レスポンスには結果、実行 ID、料金が含まれます。
POST /actions/run
AIsa Connect で作れるタスク
各ページでリクエストの順序と使うアプリを示し、コーディングエージェントで開発を始めるプロンプトを用意しています。
Shopify AI エージェントを作る
店舗がストアを一度接続すれば、エージェントが AIsa Connect で注文と在庫を読み取り、注文にタグを付けます。
AI カスタマーサポートエージェントを作る
店舗の Gmail から注文の問い合わせを読み、ストアで注文を調べて、担当者が送る返信の下書きを作ります。
EC レポートを自動化
毎週、各店舗の注文とメールキャンペーンを取得し、レポートをその店舗の Notion に書き込みます。
ユーザーがアプリを接続する 2 つの方法
OAuth アプリは AIsa がホストするページを使い、キーやストアの認証情報を使うアプリは自社のフォームで接続します。どちらも同じ種類の Connection になります。
OAuth アプリはホスト型ページで
ユーザーの接続セッションを作成してリンクを開き、完了するまでセッションをポーリングします。リンクは 30 分で失効し、サーバーが OAuth トークンを扱うことはありません。
キーとストアの認証情報は自社フォームで
Shopify の Admin API トークンとショップドメインなど、アプリが求める項目を集めて一度だけ転送します。AIsa が項目を確認したあと、アプリが認証情報を確認します。
本番環境で検証済みのアプリ
これらのアプリは本番環境でエンドツーエンドのテストを終えています。カタログ全体では 1,684 件のアプリと 21,356 件のアクションがあります。
1,684 件のアプリをすべて見るGoogle のアプリは現在、読み取り権限で接続します。本番環境で接続が動いたアプリから、この一覧に加わります。
ユーザーの代わりに動くエージェントのための安全策
ユーザーごとのアカウントは分離され、入力はアプリに届く前に検証されます。書き込みが自動で繰り返されることはなく、エラーは誰が対処すべきかを示します。
- ほかのユーザーのアカウントには届かない
- Connection は AIsa アカウントと 1 つの externalUserId に属します。実行に使われるのは、そのユーザーの Connection だけです。
- 読み取りと書き込みを明示
- 各アクションは読み取り・書き込み・削除のどれかを示すため、エージェントは変更の前に人に確認できます。
- 入力を schema で検証
- AIsa は呼び出しの前に入力を検証します。項目に誤りがあると 422 validation_failed を返し、アプリには何も届きません。
- 書き込みが勝手に繰り返されない
- AIsa は各実行を一度だけ送るため、書き込みが誤って 2 回行われることはありません。outcome_unknown で終わった場合は、アプリで状態を確認してから再実行してください。
- エラーが対処する側を示す
- 各エラーは原因がユーザー、アプリ、AIsa のどれかを示します。再接続をユーザーに頼むべきタイミングがわかります。
- 1 回のリクエストでアクセスを終了
- ユーザーが利用をやめたときや求めたときは、その Connection を削除します。一覧から消え、以降の実行では使えなくなります。
そのほかの質問はお問い合わせください。