# Show Survey

{% hint style="info" %}
Each question and answer sent as a unique message is an [interaction](/docs/getting-started/interactions.md), a consumable resource in Proto.
{% endhint %}

The Show Survey action runs a survey sequence, where preset questions are sent to the chat to collect a person's answers. The survey questions and a person's responses exist as regular back-and-forth texting in messaging apps, where the person can optionally reply "skip" to move to the next question.

***

Select a **Show Survey** action from the tree to open its settings.

## Add a Field

Press **Add Field** to generate a new question.

***

## Configure a Field

Select a **field** to modify its content:

* **Enable skip** — toggles whether to allow the question to be skippable. If enabled, the person can respond to a question with "skip", and the AI agent will progress to asking the next question.
* **Chat variable name** — creates a new [chat variable](/docs/developer-documentation/chat-variables.md) that stores the person's answer within the current chat context, allowing other actions to utilize it.
* **Question** — the question sent by the AI agent to the chat.
* **Answer must be** — the required format of the person's answer:
  * **Text** — answer can be any text content.
  * **Number** — answer must be an integer. Non-numeric characters will invalidate it.
  * **Attachment** — answer must be a single file attachment to the chat.
  * **Attachment(s)** — answer must be one or more file attachments.
  * **Email** — answer must be an email address.
  * **Phone** — answer must be a phone number.
* **Invalid answer reply** — if an answer fails validation, e.g. responding with text instead of a number, this is the AI agent's subsequent message. It can be used to provide more detail or clarification.
* **Quick answers** (optional) — up to 13 clickable buttons that appear below the sent message, allowing people to quickly choose a preset answer. These are not support by the [Bitrix24](/docs/modules/ai-agents/publishing/bitrix24.md) or [Africa's Talking](/docs/modules/ai-agents/publishing/africas-talking.md) channels.

Press **Save** to confirm edits.

***

## Delete a Field

Press <img src="/files/LUzXBmbdcksTbeyt2Bz9" alt="" data-size="line"> in a field's header to delete it.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.proto.cx/docs/modules/ai-agents/workflows-and-actions/show-survey.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.