plan_survey
Plan a survey by describing your research goals and target audience. The AI designs an effective survey structure for you, ready for review and confirmation.
Instructions
Plan a survey from a natural language description.
Describe what you want to learn and from whom. The Datapoint AI service will design an effective survey structure for you.
MEDIA: If the survey compares/rates media (images, audio, video), first call
upload_media on any local files to get dp:// refs, then mention those refs
(or public https:// URLs) directly in this description so the planner can
wire them into the datapoints. Example:
description = (
"Compare two logo designs for memorability: "
"A = dp://media/abc123.png, B = dp://media/def456.png. "
"Target: general software developers."
)Without explicit refs in the description, the planner will produce
placeholder or invented URLs that will fail at create_survey.
After this returns, present the summary and cost to the user and wait
for explicit confirmation before calling create_survey. Never chain
these two calls — create_survey spends money and dispatches real work.
Args: description: What you want to survey, in plain language. Include the target audience, what you're comparing/rating, any screening criteria — including who should answer (e.g. respondents in specific countries, excluding VPN/bot traffic, balanced regional mix) — and, for media surveys, the dp:// or https:// URLs to use. max_responses: Number of human responses per datapoint (default 10). More = higher confidence but higher cost.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | ||
| max_responses | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |