> For the complete documentation index, see [llms.txt](https://documentation.proto.cx/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.proto.cx/docs/modules/ai-agents/workflows-and-actions/show-survey.md).

# 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/developers/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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.