> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackmountain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompting Basics

> How to write prompts that get useful answers from the AI in 48°

A prompt is the message you send to the AI. The clearer it is, the less back and forth you need. You don't need special syntax: write the way you would brief a capable colleague who knows nothing about your situation yet.

## The four parts of a good prompt

Most good prompts answer four questions.

| Part | Question | Example |
| - | - | - |
| **Task** | What should the AI do? | "Write a reply to this customer email." |
| **Context** | What does it need to know? | "The customer is a long-standing client. The delivery was three days late because of a strike." |
| **Format** | What should the result look like? | "Under 150 words, friendly but professional, in German." |
| **Goal** | Why do you need it? | "I want to keep the client and offer a 5% discount on the next order." |

Compare these two prompts:

> [tab] Vague
>
> ```
> Write an email about the delay.
> ```

> [tab] Clear
>
> ```
> Write a reply to the customer email below. The customer is a long-standing
> client. Their delivery was three days late because of a strike at our
> carrier. Apologize, explain briefly, and offer a 5% discount on the next
> order. Keep it under 150 words, friendly but professional, in German.
>
> [customer email]
> ```

## Be specific

* **Name the audience.** "For our board" gives a different answer than "for new interns".
* **Set the length.** "Three bullet points" or "one paragraph" beats "short".
* **Say what to leave out.** "No marketing language" or "don't repeat the question" is as useful as what to include.
* **Ask for the format you need.** A table, a checklist, an email, code, or a slide outline.

## Give the AI the material

The AI only knows what is in the chat and in your context. Paste the text you are talking about, or attach the file. See [Attachments](https://docs.blackmountain.io/chat/attachments.md).

If you work in the same role or project often, don't repeat the background each time:

* Add who you are and how you work to an [AI profile](https://docs.blackmountain.io/chat/profiles-and-context.md).
* Group related chats in a [project](https://docs.blackmountain.io/chat/projects.md) with shared instructions and files.

## Iterate instead of starting over

The first answer is a draft. Reply in the same chat to refine it:

* "Make it shorter."
* "Use a more formal tone."
* "Turn the second point into a table."
* "You missed the deadline I mentioned. Add it."

If an answer goes in the wrong direction, edit your message and send it again, or refresh the response to get a new one. See [Chat basics](https://docs.blackmountain.io/chat/basics.md).

## Check the result

AI-generated answers can be inaccurate or incomplete. Check facts, numbers and names before you use them, especially for anything you send to customers. For current information, turn on [Web search](https://docs.blackmountain.io/chat/tools/web-search.md) so the answer cites its sources.

> [!TIP]
>
> Not sure how to start? Ask the AI to help write the prompt: "I want to prepare a negotiation with a supplier. Ask me the questions you need answered first."

## Related

> [card] [Advanced prompting](https://docs.blackmountain.io/resources/prompting-advanced.md)
>
> Structure, examples and reuse.

> [card] [Model guide](https://docs.blackmountain.io/models/model-guide.md)
>
> Pick the right model for the task.

> [card] [Prompt Studio](https://docs.blackmountain.io/chat/prompt-studio.md)
>
> Save prompts as templates.

> [card] [Questionnaires](https://docs.blackmountain.io/chat/tools/questionnaires.md)
>
> Let the AI ask you questions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.