探索
get_api_document載入目前任務所需的精確 API 契約。
適用於 SaaS 的代理程式能力層
將你的 API 轉化為無所不能的代理程式。
將產品的核心操作開放為 API，將相關文件附加到聊天中，AgentChat 就能將它們轉化為代理能力。無需為每項功能個別整合自訂工具。
4核心工具 HTTP無限能力 Headers使用者層級存取權限
一個代理層 · 產品的每項能力
你的 SaaS API
AgentChat
POST/storiesPOST/imagesGET/documents/search→
Aria4 CORE TOOLS
get_api_document()
http_request()
sleep()
view_image()
API docs = plugins. 再新增一個附有文件說明的端點，代理就會獲得一項新能力。
你的 API安全執行你的資料庫
核心理念
四個工具。涵蓋產品能夠開放的所有能力。
傳統代理需要為每個操作定義自訂工具。AgentChat 使用 API 文件和通用 HTTP 執行器，因此能力會隨著 API 涵蓋範圍擴展，而不是隨著代理程式碼擴展。
執行
http_request呼叫任何有文件說明的 HTTP 端點，並接收結構化結果。
等待
sleep在建立非同步工作與輪詢狀態之間暫停。
查看
view_image檢查創意或媒體 API 傳回的圖片 URL。
整合模型
你的資料庫始終是唯一可信的資料來源。
你的 API 是圍繞產品現有操作所建立的受控封裝。代理呼叫這些 API；你的 SaaS 讀取同一個資料庫，並以自然的方式呈現結果。
記錄你的核心操作
註冊封裝產品資料庫與業務操作的 API。它們將成為代理程式可用的能力。
建立限定範圍的聊天
僅附加該聊天所需的文件，選擇其模型，並為目前使用者或租戶新增標頭。
讓你的產品呈現結果
代理程式透過你的 API 運作。你的應用程式讀取自己的資料庫，並像平常一樣顯示新建立或更新的資料。
實際產品模式
同一套架構，完全不同的代理。
RAG / SEARCH01
為代理提供你的文件搜尋 API。
建立聊天時，附加一份搜尋 API 文件。代理可以擷取相關段落，對其進行推理，並運用應用程式的私有知識回答問題。
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 的權限。
標頭值始終只能寫入，絕不會暴露給模型。
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