refly-ai/perplexity

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.preview may be null → jq error: null (null) only strings can be parsed
• .output.preview may 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