\r \r

Felo LiveDoc Skill\r

\r

When to Use\r

\r Trigger this skill when users want to:\r \r

• Create/manage knowledge bases: Create, list, update, or delete LiveDocs\r
• Add resources: Upload documents, add URLs, or create text documents in a LiveDoc\r
• Semantic retrieval: Search across knowledge base resources using natural language queries\r
• Resource management: List, view, or delete resources within a LiveDoc\r \r Trigger words:\r
• English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval\r
• 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索\r \r Explicit commands: /felo-livedoc, "livedoc", "felo livedoc"\r \r Do NOT use for:\r
• General web search (use felo-search)\r
• PPT generation (use felo-slides)\r
• SuperAgent conversations (use felo-superAgent)\r \r

Setup\r

\r

1. Get Your API Key\r

\r

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

2. Configure API Key\r

\r Set the FELO_API_KEY environment variable:\r \r Linux/macOS:\r

export FELO_API_KEY="your-api-key-here"\r
```\r
\r
**Windows (PowerShell):**\r
```powershell\r
$env:FELO_API_KEY="your-api-key-here"\r
```\r
## How to Execute\r
\r
When this skill is triggered, execute the livedoc script using the Bash tool:\r
\r
### LiveDoc Management\r
\r
**Create a LiveDoc:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create --name "KB Name" --description "Description"\r
```\r
\r
**List LiveDocs:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list --keyword "search term"\r
```\r
\r
**Update a LiveDoc:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update SHORT_ID --name "New Name" --description "New Desc"\r
```\r
\r
**Delete a LiveDoc:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete SHORT_ID\r
```\r
\r
### Resource Management\r
\r
**Add a text document:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-doc SHORT_ID --title "Doc Title" --content "Document content here"\r
```\r
\r
**Add URLs (max 10, comma-separated):**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-urls SHORT_ID --urls "https://example.com,https://example.org"\r
```\r
\r
**Upload a file:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf --convert\r
```\r
\r
**List resources:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resources SHORT_ID\r
```\r
\r
**Get a single resource:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resource SHORT_ID RESOURCE_ID\r
```\r
\r
**Delete a resource:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs remove-resource SHORT_ID RESOURCE_ID\r
```\r
\r
### Semantic Retrieval\r
\r
**Search across resources:**\r
```bash\r
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query"\r
```\r
### Options\r
\r
All commands support:\r
- `--json` or `-j` — output raw JSON response\r
- `--timeout \x3Cms>` or `-t \x3Cms>` — request timeout in milliseconds (default: 60000)\r
\r
### Parse and Format Response\r
\r
The API returns JSON with this structure:\r
```json\r
{\r
  "status": "ok",\r
  "message": "success",\r
  "data": { ... }\r
}\r
```\r
\r
**LiveDoc object:**\r
- `short_id` — unique identifier (use this for all operations)\r
- `name` — LiveDoc name\r
- `description` — LiveDoc description\r
- `created_at` / `modified_at` — timestamps\r
\r
**Resource object:**\r
- `id` — resource identifier\r
- `title` — resource title\r
- `resource_type` — type (web, ai_doc, file, etc.)\r
- `status` — processing status\r
- `snippet` — content preview\r
\r
**Retrieve result:**\r
- `id` — resource ID\r
- `title` — resource title\r
- `content` — matched content\r
- `score` — relevance score (0-1)\r
\r
## Error Handling\r
\r
### Common Error Codes\r
\r
- `INVALID_API_KEY` — API Key is invalid or revoked\r
- `LIVEDOC_NOT_FOUND` — LiveDoc does not exist\r
- `LIVEDOC_RESOURCE_NOT_FOUND` — Resource does not exist\r
- `LIVEDOC_CREATE_FAILED` — Failed to create LiveDoc\r
- `LIVEDOC_RESOURCE_UPLOAD_FAILED` — File upload failed\r
- `LIVEDOC_RESOURCE_ADD_URLS_FAILED` — URL addition failed\r
- `LIVEDOC_RESOURCE_RETRIEVE_FAILED` — Semantic retrieval failed\r
\r
### Missing API Key\r
\r
If `FELO_API_KEY` is not set, display this message:\r
\r
```\r
ERROR: FELO_API_KEY not set. Get your API key from https://felo.ai (Settings → API Keys).\r
Set it with: export FELO_API_KEY="your-key"\r
```\r
\r
## Important Notes\r
\r
- Always use the `short_id` returned from create/list to reference a LiveDoc\r
- URL resources are limited to 10 per request\r
- Use `--convert` with upload to convert files to searchable documents\r
- Semantic retrieval returns results sorted by relevance score\r
- Execute immediately using the Bash tool — don't just describe what you would do\r