> For the complete documentation index, see [llms.txt](https://help.getswimtech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.getswimtech.com/documentation/working-smarter-with-swimtech/ai-assistance-in-swimtech/ai-note-assistant.md).

# AI Note Assistant

Use AI to refine general Notes and photo descriptions throughout SwimTech, helping technicians create clearer, more professional service documentation with less effort.

**The AI Note Assistant helps technicians communicate more clearly and professionally while reducing the time spent writing service notes.**

Notes and Notes associated with Photos are used extensively throughout the SwimTech application. They allow technicians and office personnel to document important information as work moves through SwimTech and provide valuable context about customers, service activity, equipment, Water Bodies, issues discovered, and work performed.

Because Notes are such an important part of the service record, the **AI Note Assistant** helps technicians improve the quality of those Notes without requiring them to spend additional time composing polished descriptions while working at a customer's property.

## AI-Assisted Notes

During a busy service day, technicians often enter Notes quickly. The important information may be there, but the Note may be brief, fragmented, or difficult for a customer or office staff to understand.

The AI Note Assistant can refine the technician's original Note into a clearer, more complete, and professional version while preserving the technician's intended meaning.

For example, a technician might enter a short Note such as *"pump leaking at fitting."* The AI Assistant can suggest a more descriptive version that is appropriate for the service record or a customer-facing Activity Report.

## AI-Assisted Notes for Photos

Photos are even more useful when they include an explanation of what the technician is documenting. SwimTech allows Notes to be associated with Photos so the image and its description become part of the service documentation.

A technician can quickly describe what a Photo represents and then use the AI Note Assistant to refine that description. This helps turn Photos into meaningful service documentation rather than simply storing an image without sufficient context.

Photos can help document equipment condition, repairs, unusual conditions, completed work, customer-specific concerns, or verification that an important task was completed.

## Unlimited Notes and Photos

SwimTech allows users to add **unlimited Notes and unlimited Photos throughout the application**. This gives technicians the flexibility to document as much information as necessary without having to decide which important details should be omitted because of an arbitrary Note or Photo limit.

The ability to capture detailed Notes and supporting Photos helps create a more complete service history, provides visual documentation of field conditions and completed work, improves communication between technicians and office personnel, gives customers clearer explanations, and creates information that can be referenced during future service visits.

## The Technician Remains in Control

AI provides a **suggested refinement** of the technician's Note—it does not replace the technician's judgment. The technician can review the AI-generated Note, modify it when necessary, and decide whether to accept it.

> **The goal is simple: let the technician capture the important information quickly, then use AI to help turn Notes and Photos into clear, professional, and useful service documentation.**


---

# 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.getswimtech.com/documentation/working-smarter-with-swimtech/ai-assistance-in-swimtech/ai-note-assistant.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.
