> For the complete documentation index, see [llms.txt](https://docs.jetadmin.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jetadmin.io/ai-app-builder/create-an-app/write-a-useful-prompt.md).

# Write your first prompt

A useful prompt names the users, connected data, screens, and allowed actions. Start with an outcome you can verify against a few records.

## Build the prompt

| Include       | Example                                     |
| ------------- | ------------------------------------------- |
| Users and job | Support staff reviewing incoming tickets    |
| Data source   | Tickets in the selected Jet Tables resource |
| Fields        | Name, Status, Priority, Assigned to         |
| Screens       | Ticket list and a detail view               |
| Behavior      | Filter by Status; search by Name            |
| Scope         | Read-only first version                     |

> Build a support app for staff using Tickets from the selected resource. Show Name, Status, Priority, and Assigned to in a searchable list. Add a Status filter and a detail view for a selected ticket. Use connected records and start with a read-only version.

## Send and review

1. [Select the data source](/ai-app-builder/ai-assistant/select-data-sources.md).
2. Enter the prompt by [typing or dictating](/ai-app-builder/ai-assistant/type-or-dictate-a-prompt.md).
3. Add [an image or file](/ai-app-builder/ai-assistant/upload-images-and-files.md) only when it helps explain the requirement.
4. Send the request and answer any clarification questions.
5. Compare the generated result with the fields and behavior you requested.

## Improve a vague request

Instead of “Make it better,” identify the observable change:

> On the Tickets page, place Priority beside Status and sort Open tickets first.

A prompt requesting a permission rule is a requirement to verify. It does not prove the generated app enforces that rule.

Next: [Review generated pages and logic](/ai-app-builder/refine-an-app/review-and-refine.md).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.jetadmin.io/ai-app-builder/create-an-app/write-a-useful-prompt.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.