> For the complete documentation index, see [llms.txt](https://help.brieftech.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.brieftech.ai/how-to-guides/review/refine-descriptions-from-examples.md).

# Refine descriptions using your own edits as examples

Edit a few descriptions the way you want them, then have BriefTech rewrite the rest to match.

Teach BriefTech your preferred style by editing a few descriptions by hand, then have it rewrite the rest of your selection to match.

Use this when the AI descriptions are close but not in the style, length, or detail you want.

## Steps

1. Open the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-8f18f06a78c4d0bf6e51eac54ec7d3e5d2cdb8a2%2Ftab-review.svg?alt=media" alt="Review tab" data-size="line"> tab.
2. **Edit at least one description** by hand in the style you want (two or three give better results, especially if your documents are mixed). Double-click the description cell, type, and press Enter. These hand-typed descriptions are your **examples** (also called manual description overrides).
3. **Tick the checkboxes** on both:

   * your edited rows (the **examples**), and
   * the rows you want rewritten (the **targets** — rows you have not edited).

   The button stays greyed out unless your selection includes at least one example *and* at least one target. Tick both before clicking.
4. In the toolbar, click <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-7ca852ba9ed8e5cd335486f6f5aafe2a31996043%2Fbtn-refine-descriptions.svg?alt=media" alt="Refine Descriptions" data-size="line"> — or right-click your selection and choose it from the menu.
5. Wait for the run to finish. BriefTech rewrites each target to match the style of your examples. Your edited rows are left untouched.

## Button greyed out?

Hover for the reason:

| Message                                                                                       | What to do                                                                |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| *"Select documents first"*                                                                    | Tick at least one row before clicking.                                    |
| *"Select rows that have manual description overrides to use them as examples for refinement"* | Edit a description first (double-click, type, Enter), then tick that row. |
| *"Select at least one row without a manual description override to refine"*                   | Add at least one un-edited row to the selection.                          |

## Good to know

* **Run it as often as you like.** Each run uses whatever edits are in the current selection.
* **Scope is the selection only.** Refining does not change settings or affect documents outside the selection.

## What you've built

Your target rows now carry descriptions rewritten to match the style of your hand-edited examples, while your edited rows stay untouched.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Document metadata fields</strong></td><td>The document fields you can edit in the Review tab and their accepted values.</td><td><a href="/reference/document-metadata-fields.md">Document metadata fields</a></td></tr><tr><td><strong>How AI analysis works: agents and playbooks</strong></td><td>What agents and playbooks are, and what they extract.</td><td><a href="/concepts/how-ai-analysis-works.md">How AI analysis works: agents and playbooks</a></td></tr></tbody></table>


---

# 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://help.brieftech.ai/how-to-guides/review/refine-descriptions-from-examples.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.