The First Survey Tool AI Agents Can Use Directly
Published: 08.12.2025
AI agents can now create complete, real surveys-not drafts-by generating a single clickable URL.
No UI. No accounts. No APIs.
This was the first feature we built where humans weren’t the user. We had to step back and design for agents instead, which turned out to be a very different exercise.
- Aarne Laur, Founder
What This Is
YourOpinion.is introduces a survey import mechanism designed specifically for AI agents.
An agent generates a structured Markdown survey, encodes it into a URL, and hands you a link. When you click it, the survey is instantly reconstructed as a working, shareable form.
There’s nothing to configure. Nothing to copy-paste. The entire survey lives in the URL itself.
Why This Matters
Today’s “AI survey workflows” are broken:
- Ask an AI for questions
- Copy the output
- Paste it into a survey tool
- Manually choose question types
- Rebuild pages and logic
That workflow assumes AI is just a brainstorming assistant. It’s not.
Modern agents understand survey structure, methodology, and intent. They can produce fully formed questionnaires. What they couldn’t do was deliver them directly into a usable system.
Now they can.
How It Works
The mechanism is intentionally simple.
- The agent writes a survey in Markdown.
- The Markdown is URL-encoded.
- The content is appended to the URL as a Hash Fragment (
#). - Clicking the link imports the survey instantly.
Why We Chose Client-Side Hashes (#) and URL-Encoding
We deliberately chose URL hash fragments over standard query parameters (?) for architectural reasons, not just aesthetics.
Web servers and proxies often choke on long URLs (HTTP 414 Errors) when passed as query strings. By moving the payload to the hash fragment, the data stays client-side. This allows agents to generate significantly larger, richer surveys without worrying about header limits.
URL-Encoding is the least computationally intensive way for LLMs to serialize data without using code or external tools.
Using It Today
Many LLMs don’t know about this feature yet, so for now, you need to tell them how to use the protocol.
When you ask an AI agent to create a survey, include the following instructions:
> **Survey Import Instructions**
>
> - Write the survey in Markdown
> - Use:
> - `#` for the title
> - `###` for questions
> - `-` for single-choice options
> - `- [ ]` for multi-select
> - `---` for page breaks
> - `> Logic` for conditional notes
> - URL-encode the full Markdown
> - Construct a link using:
> `https://youropinion.is/import#<encoded-markdown>`
> - Return both the Markdown and the clickable link.What Agents Can Create
The protocol supports a “Rich Markdown” dialect that allows agents to infer intent without writing complex code. Agents can build:
- Single- and multi-choice questions
- Free-text and essay responses
- Rating scales (inferred from context like “Rate 1-10”)
- Multi-page surveys (using
---) - Conditional logic (using blockquotes)
There are no explicit type declarations. The system infers intent from structure and language. This keeps the format simple and agent-friendly.
What Makes This Different
Other tools use AI to generate content. We built something AI can use.
The Import Protocol is documented at https://youropinion.is/llms.txt, an emerging convention for LLM-readable tool specs. Once agents are trained on it, they’ll know how to use YourOpinion.is automatically.
Until then, a single prompt is enough.
Try It
Ask your favorite AI agent to create a survey. Paste in the instructions above. In seconds, you’ll get a working survey link.