Настройка Harness

Mindmap API

Создавайте mindmaps из prompt и optional LiveDoc context.

POST/v2/mindmap

Аутентификация

Bearer API key

Content type

application/json

Ограничения

Могут применяться ограничения конкретного endpoint.

LiveDoc API

Mindmap API генерирует mindmap из topic, question или project request и может сохранить результат в LiveDoc для дальнейшего reuse/retrieval агентом.

Аутентификация

Authorization: Bearer YOUR_API_KEY

Create Mindmap

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

Тело запроса

Параметр	Тип	Обязательный	Описание
`query`	string	Да	topic or question for mindmap generation, max 2000 characters
`layout`	string	Нет	layout type. Default: `MIND_MAP`
`livedoc_short_id`	string	Нет	LiveDoc ID. If omitted, a new LiveDoc is created automatically

Layout Types

Layout	Description
`MIND_MAP`	Classic mind map, default
`LOGICAL_STRUCTURE`	Logical structure diagram
`ORGANIZATION_STRUCTURE`	Organization chart
`CATALOG_ORGANIZATION`	Catalog organization chart
`TIMELINE`	Timeline diagram
`FISHBONE`	Fishbone diagram

Пример

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	Resource ID of the created mindmap
`status`	string	Generation status, such as `COMPLETED`
`livedoc_short_id`	string	LiveDoc short ID where the mindmap is stored
`mindmap_url`	string	URL for viewing the mindmap
`svg`	string	SVG content of the mindmap
`message`	string	Status message

Коды ошибок

Code	HTTP Status	Описание
`INVALID_API_KEY`	401	API Key is invalid or revoked
`MINDMAP_CREATE_FAILED`	502	Mindmap creation failed
`LIVEDOC_CREATE_FAILED`	502	Failed to create LiveDoc
`LIVEDOC_NOT_FOUND`	404	Specified LiveDoc not found
`LLM_SERVICE_UNAVAILABLE`	503	LLM service is unavailable
`LLM_REQUEST_TIMEOUT`	504	LLM request timed out