配置 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 请求超时