跳轉到主要內容
action 是 agent 在網站上可以執行的單一動作:讀取商品目錄、把物件加入購物車、搜尋清單、送出表單。schema 把 action 與端點並列描述,給你的 agent 一份能力選單。

Action 類型

從 catalog 讀取 action

呼叫 GET /v1/catalog/{domain} 時,回應會把讀取端點與寫入 action 放在同一個清單:
agent 讀取 methodurlheadersparams 欄位並構建 HTTP 請求。對於支援 hosted execution 的已註冊端點,也可以用端點名稱和 params 呼叫 POST /v1/fetch

參數

每個 action 的參數會列出: body 參數用來組成 JSON 物件。query 參數附加到 URL。path 參數則填入 URL 模板中的 {placeholder} 片段。

執行 action

你可以用兩種方式執行 schema。 自行執行時,agent 直接呼叫上游網站:
Hosted execution 時,把已註冊的 site、endpoint 和 params 傳給 Hermai:
Catalog 提供 recipe。Hosted fetch 會透過 Hermai 執行已註冊端點。

貢獻 schema 中的 action

貢獻 schema 時,可以把 action 和端點一起放進來。寫入類 action(加入購物車、送出表單、登入)最容易用 hermai intercept 擷取 - 它會啟動瀏覽器,讓你在 UI 上執行動作,並記錄背後的 XHR 請求供日後重播。