基本コンセプト
ツールを見つけ、アクセスを付与し、リクエストを理解するための共通の言葉。
ツールとプラットフォーム
ツールは、正確なIDと定義された入力を持つ1つのアクションです。プラットフォームは、そのアクションが扱うサービスや対象です。複数のツールが同じプラットフォームに属することがあります。
検索や一覧取得もアクションです。Xを検索するツールはXに、Pinterestのボードを一覧するツールはPinterestに属します。
プロバイダー
プロバイダーは、ツールの背後にある機能を提供する側です。ツールによっては複数のプロバイダーから選べ、それぞれ入力、対応範囲、料金が異なります。
既定ではRelvoが呼び出しごとに自動で振り分け、実際に使ったプロバイダーの記録された費用を請求します。プロバイダーを固定するには、見積もりと実行の両方でproviderにそのIDを送ります。固定した呼び出しが別のプロバイダーに切り替わることはありません。プロバイダーの一覧で提供元を探せます。
チームとプロジェクト
チームは、メンバーとプラン・残高をまとめる単位です。プロジェクトは、関連する認証情報・アクセス・作業を選んだ文脈の中に保持します。何を見られるか、何を実行できるかは、チームのロールとプロジェクトのロールで決まります。詳しくはチームとプロジェクトを参照してください。
APIキーはそのプロジェクトの文脈に属します。アプリでプロジェクトを切り替えると、操作対象の文脈も切り替わります。
見積もりと請求
呼び出しはすべて、実行前に見積もられます。無料の見積もりは、その呼び出しの最大料金（maximumChargeMicros）と、使った料金のバージョンを返します。実行するとその額をチームの前払い残高から予約し、終わると実費を1回だけ請求して残りを戻します。
料金は米ドルのmicrosの整数です。1,000,000 microsが1米ドルです。
実行と結果
実行（execution）は、ツールを動かそうとした1回の試行を記録したものです。識別子と進捗を持ち、最後に結果またはエラーが付きます。結果には構造化データ、テキスト、生成ファイルへのリンクが含まれることがあります。
進捗を追うとき、失敗を調べるとき、サポートに問い合わせるときは、実行IDを控えてください。
接続したアプリ
プロジェクト管理者が、選択中のプロジェクトで使うアカウントを接続 ↗でつなぎます。アプリごとに、github__issues_createのような<app>__<operation>という名前のツールがプロジェクトのカタログに加わります。引数のconnectionIdに接続のIDを渡すか、autoでそのプロジェクト内の利用可能な接続を選びます。
保存した認証情報がエージェントに渡ることはありません。Relvoがリクエストごとに付け、レスポンスの秘密情報を伏せます。プロジェクト管理者は、接続のメソッド・パスを全員共通で制限したり、読み取り専用や変更前の承認必須にしたりできます。この制限はプロジェクトの全メンバーに共通で、APIキーごとにさらに絞ることもできます。