refly-ai Perplexity
AI-powered search and chat with Perplexity. Use when you need to: (1) get AI responses with real-time web search, or (2) answer questions with up-to-date information.
Input
Provide input as JSON:
{
"query": "Your search query or question"
}
Execution
Step 1: Run the Skill
refly skill run --id skpi-sww12wxvy9zbfr1wwx35gybm --input '{
"query": "Your question here"
}'
Step 2: Wait for Completion
refly workflow status c-xz42o3itzw4bdnnhoovb16dv --watch --interval 10000
Step 3: Get the Run ID
refly workflow runs c-xz42o3itzw4bdnnhoovb16dv --limit 1
Look for runId in the output (format: we-xxx).
Step 4: Get the Result ID
refly workflow detail <RUN_ID>
Look for resultId in the skillResponse node (format: ar-xxx).
Step 5: Extract the Content
refly workflow result <RESULT_ID> --include-messages --raw
The AI response is in .payload.messages[] where type is "ai". Extract with:
refly workflow result <RESULT_ID> --include-messages --raw | jq -r '.payload.messages[] | select(.type=="ai") | .content'
Alternative: One-liner (after Step 2)
RUN_ID=$(refly workflow runs c-xz42o3itzw4bdnnhoovb16dv --limit 1 | jq -r '.payload.runs[0].runId') && \
RESULT_ID=$(refly workflow detail "$RUN_ID" | jq -r '.payload.nodes[] | select(.nodeType=="skillResponse") | .resultId') && \
refly workflow result "$RESULT_ID" --include-messages --raw | jq -r '.payload.messages[] | select(.type=="ai") | .content'
Key Concepts
| ID Type | Format | How to Get | Used For |
|---|---|---|---|
| workflowId | c-xxx |
In SKILL.md frontmatter | workflow status, workflow runs |
| runId | we-xxx |
From workflow runs or workflow status output |
workflow detail, workflow toolcalls |
| resultId | ar-xxx |
From workflow detail → nodes[].resultId |
workflow result |
Common Mistakes to Avoid
Do NOT use toolcalls with .output.preview
# WRONG - This will fail!
refly workflow toolcalls <RUN_ID> --latest | jq -r '.payload.toolCalls[-1].output.preview | fromjson | .data.response'
Why it fails:
.output.previewmay benull→ jq error:null (null) only strings can be parsed.output.previewmay be truncated → jq error:Unfinished string at EOF- The preview field is not guaranteed to exist
Always use this instead:
refly workflow result <RESULT_ID> --include-messages --raw | jq -r '.payload.messages[] | select(.type=="ai") | .content'
Expected Output
- Type: Text content with citations
- Format: AI-generated response from Perplexity with web search results
- Action: Display content to user