# Assistant

The following screenshot is an example of a Carson Assistant field configured with the most strict options. The prompt, which defaults to "Summarize this page." is hidden to the user and can not be changed. Using the field settings (see screenshot below) you can change the default prompt value. For example you could change the button label to "Make this blog post sound more professional and academic." It will use the content from the current entry (by using the Live Preview output if Live Preview is enabled, or the form field values) as the context, and place the response into a chosen text, textarea, or RTE field.

<figure><picture><source srcset="/files/huCztnISrvgH6IeizBW6" media="(prefers-color-scheme: dark)"><img src="/files/GIOYcAQ0xGPoXta5Wp8u" alt=""></picture><figcaption></figcaption></figure>

The following screenshot is of the Assistant field configured to display the prompt field, but *not* use itself for the target of the output. Meaning the result from OpenAI will be placed in another targeted text, text area, or RTE field. The user can change the default prompt value to anything they want. For example, they could use it to generate a blog post, or improve the writing of the current entry if Force Context is enabled.

<figure><picture><source srcset="/files/H1yjyejT4Ec5ROzCSb9h" media="(prefers-color-scheme: dark)"><img src="/files/U85RkRFU47MZaRacK0UP" alt=""></picture><figcaption></figcaption></figure>

This screenshot is an example of the Assistant field configured to use itself as a target of the output. This can be useful if you are adding Carson to an entry and need to copy and paste to split up the results of the response into separate fields, such as fields inside of Fluid, Bloqs, or Grid. Think of it is an AI clipboard directly in the entry that uses the entry's content to supply additional context to the prompt.

<figure><picture><source srcset="/files/fSaY8DmtyOjGy35qfa7g" media="(prefers-color-scheme: dark)"><img src="/files/7rQ3b5iceFm7XAhRbmta" alt=""></picture><figcaption></figcaption></figure>

The Carson Assistant field settings. As noted in the previous screenshots the options presented to the user and how the field functions can be configured here. Since this is a fieldtype, you can create multiple assistants and add them to the same entry, or an assistant field to each channel.

<figure><picture><source srcset="/files/ZbRzaOD43KJLylGymKEq" media="(prefers-color-scheme: dark)"><img src="/files/XT2f61wI43FefaCKFteS" alt=""></picture><figcaption></figcaption></figure>


---

# 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://docs.boldminded.com/carson/docs/fields/assistant.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.
