発見
get_api_document現在のタスクに必要な正確な API コントラクトを読み込みます。
SaaS のためのエージェント機能レイヤー
API を何でもできるエージェントに変えましょう。
製品の中核業務をAPIとして公開し、そのドキュメントをチャットに紐づけると、AgentChatがそれらをエージェントの機能に変換します。機能ごとにカスタムツールを統合する必要はありません。
4コアツール HTTP無限の機能 Headersユーザーレベルのアクセス
1つのエージェントレイヤー · 製品のすべての機能
SaaS API
AgentChat
POST/storiesPOST/imagesGET/documents/search→
Aria4 CORE TOOLS
get_api_document()
http_request()
sleep()
view_image()
API docs = plugins. ドキュメント化されたエンドポイントを1つ追加するだけで、エージェントに新たな機能が加わります。
あなたのAPI安全な実行あなたのデータベース
中核となる考え方
4つのツール。製品が公開できるすべての機能。
従来のエージェントでは、アクションごとにカスタムツールの定義が必要です。AgentChatはAPIドキュメントと汎用HTTP実行機能を利用するため、機能はエージェントのコードではなく、APIの範囲に応じて拡張されます。
実行
http_requestドキュメント化された任意の HTTP エンドポイントを呼び出し、構造化された結果を受け取ります。
待機
sleep非同期ジョブの作成とステータスのポーリングの間に一時停止します。
確認
view_imageクリエイティブ API やメディア API から返された画像 URL を確認します。
統合モデル
データベースが唯一の信頼できる情報源であり続けます。
APIは、製品がすでに実行している処理を制御するラッパーです。エージェントがAPIを呼び出すと、SaaSは同じデータベースを読み取り、結果を自然に表示します。
コア操作をドキュメント化する
プロダクトデータベースやビジネスアクションを扱う API を登録します。これらがエージェントの利用可能な機能になります。
スコープを限定したチャットを作成する
そのチャットに必要なドキュメントだけを添付し、モデルを選択して、現在のユーザーまたはテナント用のヘッダーを追加します。
プロダクト側で結果を表示する
エージェントはあなたの API を通じて動作します。アプリケーションは独自のデータベースを読み取り、作成または更新されたデータを通常どおり表示します。
実際の製品パターン
1つのアーキテクチャで、まったく異なるエージェントを実現。
RAG / SEARCH01
エージェントにドキュメント検索APIを提供します。
チャットの作成時に、検索APIのドキュメントを1つ添付します。エージェントは関連する文章を取得し、それらをもとに推論して、アプリケーション固有の非公開ナレッジに基づいて回答できます。
GET /documents/search?q=...
→ {
"results": [
{ "text": "...", "source": "..." }
]
}AI STORY STUDIO02
ストーリーの作成を会話に変える。
ストーリー作成APIと画像生成APIを提供します。エージェントは章を執筆し、プロンプトからイラストを生成し、両方をあなたのAPI経由で保存します。ストーリーアプリは独自のデータベースからそれらを表示します。
POST/stories
POST/images → image_url
PUT/stories/{id}/chapters
テナント対応のセキュリティ
同じAPIドキュメントで、ユーザーごとに異なるアクセス権限。
各チャットにホスト固有のヘッダーを設定します。APIは現在のユーザーまたはテナントの認証情報を受け取り、独自の認可ルールを適用して、そのユーザーにアクセスを許可されたデータのみを返します。
チャットごとのヘッダー注入
CHAT / USER A
X-Tenant-ID: tenant_aテナントAのデータのみを検索・変更できます。
CHAT / USER B
X-Tenant-ID: tenant_b同じAPIコントラクトを、テナントBの権限で使用します。
ヘッダー値は書き込み専用のままで、モデルに公開されることはありません。
開発者 API
2つのリソースでエージェント層を追加します。
APIドキュメントを登録し、それを参照するチャットセッションを作成します。あなたのプロダクトは、同じAPIを通じて実行を開始し、永続メッセージをポーリングできます。
開発者ダッシュボードを開く →https://agent.iamdev.me
POST/api/api-documents # 機能を定義する
POST/api/agent/sessions # チャットのスコープを設定する
POST/api/agent/sessions/{id}/chat
GET/api/agent/sessions/{id}/messages
AgentChat