Felo LiveDoc Skill

When to Use

Trigger this skill when users want to:

• Create/manage knowledge bases: Create, list, update, or delete LiveDocs
• Add resources: Upload documents, add URLs, or create text documents in a LiveDoc
• Semantic retrieval: Search across knowledge base resources using natural language queries
• Route resources: Find relevant resource IDs by query for targeted retrieval
• Resource management: List, view, or delete resources within a LiveDoc

Trigger words:

• English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval, route resources
• 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索

Explicit commands: /felo-livedoc, "livedoc", "felo livedoc"

Do NOT use for:

• General web search (use felo-search)
• PPT generation (use felo-slides)
• SuperAgent conversations (use felo-superAgent)

Setup

1. Get Your API Key

1. Visit felo.ai and log in (or register)
2. Click your avatar in the top right corner → Settings
3. Navigate to the "API Keys" tab
4. Click "Create New Key" to generate a new API Key
5. Copy and save your API Key securely

2. Configure API Key

Set the FELO_API_KEY environment variable:

Linux/macOS:

export FELO_API_KEY="your-api-key-here"

Windows (PowerShell):

$env:FELO_API_KEY="your-api-key-here"

How to Execute

When this skill is triggered, execute the livedoc script using the Bash tool:

LiveDoc Management

Create a LiveDoc:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create --name "KB Name" --description "Description"

List LiveDocs:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list --keyword "search term"

Update a LiveDoc:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update SHORT_ID --name "New Name" --description "New Desc"

Delete a LiveDoc:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete SHORT_ID

Resource Management

Add a text document:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-doc SHORT_ID --title "Doc Title" --content "Document content here"

Add URLs (max 10, comma-separated):

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-urls SHORT_ID --urls "https://example.com,https://example.org"

Upload a file:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf --convert

List resources:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resources SHORT_ID

Get a single resource:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resource SHORT_ID RESOURCE_ID

Delete a resource:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs remove-resource SHORT_ID RESOURCE_ID

Semantic Retrieval

Route relevant resources by query:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs route SHORT_ID --query "your search query"
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs route SHORT_ID --query "your search query" --max-resources 5

Search across all resources (auto-routes):

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query"

Search within specific resources:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query" --resource-ids "id1,id2,id3"

Options

All commands support:

• --json or -j — output raw JSON response
• --timeout <ms> or -t <ms> — request timeout in milliseconds (default: 60000)

Parse and Format Response

The API returns JSON with this structure:

{
  "status": "ok",
  "message": "success",
  "data": { ... }
}

LiveDoc object:

• short_id — unique identifier (use this for all operations)
• name — LiveDoc name
• description — LiveDoc description
• created_at / modified_at — timestamps

Resource object:

• id — resource identifier
• title — resource title
• resource_type — type (web, ai_doc, file, etc.)
• status — processing status
• snippet — content preview

Retrieve result:

• id — resource ID
• title — resource title
• content — matched content
• score — relevance score (0-1)

Error Handling

Common Error Codes

• INVALID_API_KEY — API Key is invalid or revoked
• LIVEDOC_NOT_FOUND — LiveDoc does not exist
• LIVEDOC_RESOURCE_NOT_FOUND — Resource does not exist
• LIVEDOC_CREATE_FAILED — Failed to create LiveDoc
• LIVEDOC_RESOURCE_UPLOAD_FAILED — File upload failed
• LIVEDOC_RESOURCE_ADD_URLS_FAILED — URL addition failed
• LIVEDOC_RESOURCE_RETRIEVE_FAILED — Semantic retrieval failed

Missing API Key

If FELO_API_KEY is not set, display this message:

ERROR: FELO_API_KEY not set. Get your API key from https://felo.ai (Settings → API Keys).
Set it with: export FELO_API_KEY="your-key"

Important Notes

• Always use the short_id returned from create/list to reference a LiveDoc
• URL resources are limited to 10 per request
• Use --convert with upload to convert files to searchable documents
• Semantic retrieval returns results sorted by relevance score
• Execute immediately using the Bash tool — don't just describe what you would do