Agent Question Forms Agent instructions

Collect answers to several questions in one link.

An agent defines a form in the URL. The recipient fills it out once, then copies the answers back to the conversation. No account, server storage, or integration required.

One set of questions

Text, long text, numbers, dates, dropdowns, multiple choice, and checkboxes in one form.

Private by design

The form definition sits after # in the URL. Draft answers are saved only in this browser; nothing is submitted to a server.

Easy to return

Required answers are checked before a structured JSON response appears with a copy button.

For agents

  1. Create a JSON object with a unique id, a title, and a questions array. Give every question a unique id, label, and type.
  2. Build the URL as https://<hostname>/# plus encodeURIComponent(JSON.stringify(form)). Send that link to the person.
  3. Ask them to complete the form and paste the copied JSON into the conversation. Use a new form id to start a fresh draft, even if the questions are identical.

Large definitions produce long links. Check that your chat app preserves the whole URL. Never put secrets in the definition or URL.

Example form definition

Optional fields: description on the form or a question, required, placeholder, and options for choice questions. See the full specification.

Supported types

text, textarea, number, date, select, multiselect, checkbox. Options can be strings or objects with value and label.