設定 Harness

Mindmap API

基於 prompt 和可選 LiveDoc 上下文建立 mindmaps。

POST/v2/mindmap

認證

Bearer API key

Content type

application/json

限流說明

可能適用 endpoint 專屬限制。

LiveDoc API

Mindmap API 用於從一個主題、問題或專案需求生成心智圖，並可把結果儲存到 LiveDoc 中，方便 Agent 後續複用、檢索和交付。

認證

Authorization: Bearer YOUR_API_KEY

Create Mindmap

POST https://openapi.felo.ai/v2/mindmap

請求 Body

引數	型別	必填	說明
`query`	string	是	用於生成心智圖的主題或問題，最多 2000 字元
`layout`	string	否	版面型別，預設 `MIND_MAP`
`livedoc_short_id`	string	否	LiveDoc ID；不傳時會自動建立新的 LiveDoc

Layout Types

Layout	Description
`MIND_MAP`	經典心智圖，預設值
`LOGICAL_STRUCTURE`	邏輯結構圖
`ORGANIZATION_STRUCTURE`	組織結構圖
`CATALOG_ORGANIZATION`	目錄組織圖
`TIMELINE`	時間軸
`FISHBONE`	魚骨圖

範例

curl -X POST 'https://openapi.felo.ai/v2/mindmap' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"query":"Artificial Intelligence trends in 2024","layout":"MIND_MAP"}'

回應欄位

欄位	型別	說明
`resource_id`	string	已建立心智圖的資源 ID
`status`	string	生成狀態，例如 `COMPLETED`
`livedoc_short_id`	string	儲存該心智圖的 LiveDoc short ID
`mindmap_url`	string	檢視心智圖的 URL
`svg`	string	心智圖 SVG 內容
`message`	string	狀態訊息

錯誤碼

Code	HTTP Status	說明
`INVALID_API_KEY`	401	API Key 無效或已撤銷
`MINDMAP_CREATE_FAILED`	502	心智圖建立失敗
`LIVEDOC_CREATE_FAILED`	502	建立 LiveDoc 失敗
`LIVEDOC_NOT_FOUND`	404	指定 LiveDoc 不存在
`LLM_SERVICE_UNAVAILABLE`	503	LLM 服務不可用
`LLM_REQUEST_TIMEOUT`	504	LLM 請求逾時