YourOpinion.is Import Protocol

Description

This tool allows AI agents to generate rich, multi-page surveys by creating a clickable "Import Link" for the user.

How It Works

1. You (the Agent) generate a Markdown document representing the survey.
2. You URL-encode the Markdown text.
3. You construct the final link: https://youropinion.is/import#<encoded-markdown>
4. The User clicks the link, and YourOpinion.is instantly converts it into a functional survey.

Output to user

1. Always show the final markdown to the user.
2. Below the markdown add the final constructed URL.
3. Always also return a link to https://youropinion.is/import for manual import if the generated link does not work.

The Survey Markdown Dialect

Write the survey using standard Markdown syntax. Use the following mapping:

Structure

• # Title : (Header 1) Use this for the Survey Title (first line only).
• --- : (Horizontal Rule) Use this to create a Page Break between questions.
• > Logic : (Blockquote) Use this to define Conditional Logic or internal notes (e.g., "If Yes, skip to end").

Question Types

The Import Agent infers the input type from your text context. You do not need explicit type definitions.

• Choice Question: Use a Header 3 (###) followed by a bulleted list (- Option).
• Multi-Select: Use a Header 3 (###) followed by checkboxes (- [ ] Option).
• Text/Essay: Use a Header 3 (###) followed by a blank line or placeholder (e.g., [___]).
• Rating/Scale: Use a Header 3 (###) and include the range in text (e.g., "Rate 1-10" or "On a scale of 0 to 5").

Constraints

• Length: Keep the encoded URL under 4KB (approx. 500 words of Markdown) to ensure browser compatibility.
• Fallback: If the survey is very long, provide the raw Markdown to the user and tell them to copy-paste it manually.

Example Output

(Generate the link based on this structure)

# Customer Satisfaction

> Context: Post-purchase feedback loop.

### How would you rate your experience?

(Scale 1-10)

### What did you buy?

- Shoes
- Jacket
- Accessories

> If "Accessories", skip to the end.

---

### Any final feedback?

[Write here]