> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbased.health/llms.txt
> Use this file to discover all available pages before exploring further.
# See what getbased asks AI
> Find the instruction used by chat, imports, insights, and Light & Sun—and see what information is included with it.
# See what getbased asks AI
Whenever getbased uses AI, it sends an instruction that describes the job. Chat receives an instruction about answering health and lab questions. A report import receives a different instruction about extracting dates, markers, values, and ranges. Other features have their own focused instructions.
This guide lets you start with something you did in the app and answer four questions:
* What did getbased ask the AI to do?
* What information was included?
* Could I review or edit the message first?
* Where can I read the complete wording?
Want to inspect the wording immediately? Go to [Find a prompt by feature](#find-a-prompt-by-feature), choose the action, and follow its link in the **Read** column.
## Start with what you did
See what surrounds your message and which profile information can be included.
See the message getbased prepares and whether you can edit it first.
Browse report imports, summaries, Biology Scores, EMF, Light & Sun, and more.
Review context controls, attachments, chat history, and provider boundaries.
## A prompt in plain language
A request to an AI usually contains three parts:
```text theme={null}
what getbased asks the AI to do
+ the information needed for that job
+ your question, file, image, or selected record
= the request sent to your chosen AI service
```
The first part is the **prompt** or **instruction**. It can set the AI's role, limits, writing style, and required answer format. The second part is the **context**—for example, enabled lab results or one Light & Sun session. The final part is the immediate task, such as your chat message or the report that needs to be read. Your **AI provider** is the outside service or local model you selected to process that request.
A prompt guides a model; it does not guarantee a correct answer. AI text can still be incomplete or wrong. Keep medical decisions with a qualified professional.
## When you send a chat message
getbased sends the words you typed as your message. It does not silently rewrite them. Around that message, it can add the normal chat instruction, enabled profile information, recent conversation history, and optional tools such as a personality or Knowledge Base.
Here is the plain-language shape of a normal request:
```text theme={null}
GETBASED'S INSTRUCTION
Act as the getbased lab analyst.
Use supplied facts and dates.
Explain patterns carefully and stay within the documented health boundaries.
INFORMATION ADDED FOR THIS CHAT
Enabled profile and lab context
Optional Knowledge Base passages
Optional personality
Up to the last 30 eligible conversation messages
YOUR MESSAGE
The exact text you sent
```
If you attach images, the current message also contains the prepared image data. If web search is enabled and supported, search results can be added before the answer is generated.
Read the maintained [chat instruction](/developers/system-prompts-chat#prompt-chat-base) and the [optional chat additions](/developers/system-prompts-chat#prompt-chat-context). Braces such as `{enabled profile context}` stand for information filled in when you send.
### A simple example
Suppose you write: “Why has my ferritin fallen over the last year?”
The AI can receive:
* that exact question;
* the getbased chat instruction;
* enabled ferritin values, dates, ranges, and relevant notes;
* enabled supplement, medication, diet, cycle, or other profile context;
* recent messages in the same conversation;
* an optional personality and relevant Knowledge Base passages.
It does not automatically receive every stored item. The request uses the sources enabled for AI and the information selected for that feature.
## When you use Ask AI
An **Ask AI**, **Discuss**, or chat-shortcut button can create the user message for you. This app-written message is separate from the chat instruction, and both are documented.
Most feature buttons open chat with the message in the composer. You can read it, change it, or delete it before sending. A small number of explicit shortcuts send their documented message immediately after you click; the full list labels those actions.
For example, a marker action starts with a message shaped like:
```text theme={null}
Tell me about my {marker name} results.
Values: {dated values and units}.
Current status: {status}.
What matters most, what does this mean, and should I be concerned?
Lead with the main takeaway and keep range comparisons brief.
```
The AI is asked to begin with one useful interpretation, not a list of every possible range. The range paired with the current status is its starting frame. If a supplied reference interval and optimal band lead to meaningfully different conclusions, it can summarize that difference in one sentence. It should bring in another published threshold only when you ask about alternatives or when the difference materially changes a safety-relevant interpretation.
An outside number is not treated as a special “model range.” With Web or a Knowledge Base source available, the AI is asked to identify the source and relevant population or purpose. Without a verifiable source, it should keep remembered thresholds secondary and make the uncertainty clear.
Other app-written messages cover correlations, Genome findings, recommendations, Biology Score coverage, supplement evidence, Light Audit comparisons, and EMF follow-up.
[Read every app-written chat message](/developers/system-prompts-chat#prompt-chat-prefills), including which actions prefill the composer and which send after the click.
## Find a prompt by feature
Choose the part of getbased you used. The final column opens the complete maintained instruction. Technical values that only exist at send time are shown as readable placeholders.
| What you do | What getbased asks AI to do | Information that can be included | Read |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Send your own chat message | Answer as a cautious lab and health-data analyst | Your exact message, enabled profile context, recent chat, attachments, and optional Knowledge Base or web results | [Main instruction](/developers/system-prompts-chat#prompt-chat-base) · [Added context](/developers/system-prompts-chat#prompt-chat-context) |
| Choose **Ask AI**, **Discuss**, or a chat shortcut | Use an app-written question for the selected marker, score, finding, recommendation, or comparison | The focused values or record named in that message, followed by normal chat context | [App-written messages](/developers/system-prompts-chat#prompt-chat-prefills) |
| Continue an answer that hit its output limit | Resume exactly where the answer stopped without repeating it | The earlier request and partial response | [Continuation message](/developers/system-prompts-chat#prompt-chat-continue) |
| Run a multi-persona discussion | Ask each selected personality for an initial view, response, or joining view | Normal chat context and earlier participants' answers | [Discussion messages](/developers/system-prompts-chat#prompt-chat-discussion) |
| Generate a custom personality draft | Draft editable communication and reasoning instructions for the person or style you name | The name, archetype, character, or style you entered; not your health profile | [Personality draft prompt](/developers/system-prompts-chat#prompt-chat-persona-generator) |
| Save a consultation summary | Turn the selected conversation into findings, action items, and open questions | A limited copy of the eligible conversation | [Summary prompt](/developers/system-prompts-chat#prompt-chat-summary) |
| Use an Interpretive Lens | Add your saved lens text to the normal chat instruction without rewriting it | Your own lens text and normal chat context | [Added context](/developers/system-prompts-chat#prompt-chat-context) |
| Use a Knowledge Base with query rewriting | Create several search phrases, retrieve related passages, and add them to normal chat | Your question and selected passages from the connected library | [Search rewrite prompt](/developers/system-prompts-chat#prompt-lens-rewrite) |
| What you do | What getbased asks AI to do | Information that can be included | Read |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Import a text-based lab PDF | First identify the report type, then extract dates, markers, values, units, and printed ranges | A short report sample for identification, then prepared report text and the current marker list | [Identification](/developers/system-prompts-imports#prompt-import-classify) · [Text extraction](/developers/system-prompts-imports#prompt-import-lab-text) |
| Import photographed or scanned report pages | Read every supplied page and extract the same lab fields | The selected page images, optional filename, marker list, and date guidance | [Image extraction](/developers/system-prompts-imports#prompt-import-lab-image) |
| Read collection time or fasting status | Use only an explicitly labeled collection time or fasting statement | Statements present in the report; no guess from test type or clock time | [Collection rules](/developers/system-prompts-imports#prompt-import-collection-context) |
| Use optional compatible local-model privacy cleanup | Replace likely personal identifiers while preserving lab data | Prepared report text sent to the configured compatible local endpoint for this step | [Privacy-cleanup prompt](/developers/system-prompts-imports#prompt-privacy-local-pii) |
| Review supplement or medication photos or a product page | Separate active ingredients, other ingredients, directions, warnings, and quality-test results | Up to four selected images or a limited amount of public product-page text | [Product extraction prompt](/developers/system-prompts-imports#prompt-import-supplement) |
| Review a light-device photo or product page | Extract only stated device type, wavelengths, modes, distances, and measurements | The selected image or a limited amount of public page text | [Device extraction prompt](/developers/system-prompts-imports#prompt-import-light-device) |
| Import an EMF assessment PDF | Extract room-by-room readings, sources, and mitigations into a review draft | Prepared report text and the supported measurement types | [EMF import prompt](/developers/system-prompts-imports#prompt-import-emf) |
| What happens | What getbased asks AI to do | Information that can be included | Read |
| -------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Generate a practitioner report overview | Summarize the selected report into a short practitioner-facing overview | Only the report sections and profile sources selected in the report builder | [Report prompt](/developers/system-prompts-insights#prompt-insight-report-summary) |
| Generate or refresh **Current Focus** | Highlight the most important current pattern and a useful next step | A limited selection of goals, conditions, flagged markers, changes, supplements, and optional Knowledge Base passages | [Current Focus prompt](/developers/system-prompts-insights#prompt-insight-focus-card) |
| Refresh profile-card summaries and dots | Summarize only the requested profile areas and return a short status and tip | The stale profile areas being refreshed | [Profile summary prompt](/developers/system-prompts-insights#prompt-insight-context-dots) |
| Open a custom marker description that has not been created yet | Explain what the marker measures in one sentence | The marker name and unit; no profile context | [Marker description prompt](/developers/system-prompts-insights#prompt-insight-marker-description) |
| Explain a Biology Score | Explain the result already calculated by getbased without recalculating it | The score, supplied ranges, coverage, flags, dates, and missing markers | [Score explanation prompt](/developers/system-prompts-insights#prompt-insight-biology-score) |
| Ask AI to suggest Biology Score context | Suggest only supported context flags for your review | A limited set of relevant profile context; suggestions do not apply themselves | [Context-review prompt](/developers/system-prompts-insights#prompt-insight-biology-context) |
| Generate supplement-impact dots | Describe before/after marker patterns without proving causation | Supplement periods and computed before/after marker summaries | [Impact prompt](/developers/system-prompts-insights#prompt-insight-supplement-impact) |
| Interpret or compare EMF assessments | Explain the strongest readings and practical priorities | One assessment or the selected before/after pair | [EMF interpretation prompt](/developers/system-prompts-insights#prompt-insight-emf) |
| What happens | What getbased asks AI to do | Information that can be included | Read |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Save a supported Light Tool measurement | Interpret one measurement while respecting its measurement limits | That result and its source, calibration, timing, room, and quality information | [Measurement prompt](/developers/system-prompts-light#prompt-light-measurement) |
| Open the daily view with logged activity | Summarize the day's timing, sources, clear warnings, and one useful next step | Today's Sun/device sessions, tools, environment, trends, warnings, and relevant goals | [Today prompt](/developers/system-prompts-light#prompt-light-today) |
| View a room with enough information | Describe the room's light pattern and uncertainty | That room, related measurements, timing, sources, screens, and measurement quality | [Room prompt](/developers/system-prompts-light#prompt-light-room) |
| Request a completed device-session verdict | Interpret the setup actually used without inventing a protocol | The session, device class, active mode, firing wavelengths, modeled values, distance quality, and safety flags | [Device-session prompt](/developers/system-prompts-light#prompt-light-device-session) |
| View a configured screen | Describe the recorded evening-use pattern without claiming a measured dose | Device type, room, hours after sunset, tint/blocker settings, and entered habits | [Screen prompt](/developers/system-prompts-light#prompt-light-screen) |
| Open the seven-day review | Compare current and previous logged patterns without treating missing logs as missing exposure | Current and previous seven-day Sun/device activity | [Weekly prompt](/developers/system-prompts-light#prompt-light-weekly-pattern) |
| Save a multi-room Light Audit | Synthesize the frozen room, screen, and measurement snapshot | Audit rooms, screens, and nearby measurements in the documented date window | [Audit prompt](/developers/system-prompts-light#prompt-light-audit) |
| Request a completed Sun-session verdict | Explain the modeled signals, timing, uncertainty, and supplied safety state | That session's solar phase, modeled signals, weather, body/eye context, and cautions | [Sun-session prompt](/developers/system-prompts-light#prompt-light-sun-session) |
| Complete Light & Sun setup | Summarize which parts of the saved setup matter most | Saved skin-model reference, location, eyewear, protection, and lighting-environment answers | [Setup prompt](/developers/system-prompts-light#prompt-light-onboarding) |
| View the indoor-light burden summary | Explain the strongest current room/screen pattern and missing evidence | Current mapped rooms, screens, screening signals, and evidence quality | [Indoor summary prompt](/developers/system-prompts-light#prompt-light-indoor-burden) |
Seven Light & Sun instructions also include the same [fixture and flicker safety rules](/developers/system-prompts-light#prompt-light-hardware-guardrails).
## Know what happens before sending
| Kind of action | What you can see first |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Message you type | The exact message remains in the composer until you send it. |
| Most **Ask AI** actions | The app-written message appears in the composer and can be edited or removed. |
| Immediate chat shortcut | The documented message is sent after you deliberately click that shortcut. |
| Focused feature such as a summary or Light verdict | There is no chat composer. The feature uses its documented instruction and the selected record. |
| Report or product extraction | You select the file, image, or page first. Extracted facts appear in a review step before they are saved. |
A review screen lets you correct AI-extracted results before saving; it does not mean the provider never received the selected file or prepared content. Check the feature's privacy note before starting an import.
## Control what information is included
For ordinary chat, open **Insight → Manage → Context** to choose which stored sources may influence later requests. Turning a source off keeps it stored but excludes it from new in-app AI context.
Depending on the action, a request can also include:
* recent messages from the current conversation;
* images attached to the current message;
* the report, product page, measurement, session, room, or assessment you selected;
* an active personality;
* selected Knowledge Base passages;
* web-search results when web search is enabled and supported.
The AI provider selected in **Settings → AI** receives the assembled request. A local or private connection can change where and how it is transported, but it does not remove information that the selected feature needs for the request.
See [Privacy and data storage](/guides/privacy), [Connect an AI provider](/ai-providers), and [Local encryption](/guides/encryption) for the storage and transport boundaries.
## Understand the wording you see
Read the full prompt blocks in two simple ways:
| Label | Meaning |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Exact wording** | The displayed sentences match the fixed wording maintained in the app. |
| **Template wording** | The fixed wording is shown, while changing values are replaced with braces such as `{report text}` or `{marker name}`. |
No public documentation can display a future request containing your live private information. Placeholders show where that information would appear without publishing it.
The prompt ID and source-file link on the full page are there for reviewers and contributors. You do not need to understand the code to read the instruction block.
## Understand the result
AI has different responsibilities in different features:
* **Chat and interpretations** return model-written explanations. They are not independently fact-checked.
* **Imports** return structured candidates that getbased parses, normalizes, and shows for review before saving.
* **Short dots and verdicts** accept only known display values and limit output length, but their wording is still AI-generated.
* **Biology Scores, calculated markers, displayed ranges and statuses, and Light dose calculations** come from fixed calculations or stored source data. AI can explain them and may compare them with clearly labeled external guidance, but it does not change what the app calculated or displayed.
If an import or verdict response is missing the fields getbased expects, it normally fails, falls back to a neutral state, or stays out of saved data. A valid-looking answer can still be factually wrong, so review important results.
## Common questions
No. Your current text is sent as the user message. The app adds its instruction and permitted context around it. Image attachments change the technical message format, but not the text you wrote.
No. Chat uses enabled context sources and limited summaries. Feature-specific actions can add the selected marker, finding, or record. Use **Insight → Manage → Context** to turn sources on or off.
It uses the normal chat instruction plus an app-written user message for that action. Most of those messages are visible and editable in the composer. All current templates are listed under [app-written chat messages](/developers/system-prompts-chat#prompt-chat-prefills).
Chat starts with the range paired with the status supplied by getbased. It is told to treat that range as a comparison frame rather than universal medical truth. Routine answers should not list every available range. When a lab interval, optimal band, or relevant published threshold changes the takeaway, chat should state the difference briefly and label which frame produced each conclusion. You can always ask for a deeper range or source comparison.
The main extraction and analysis instructions are maintained with the app because changes can affect safety, parsing, and compatibility. You can change your message, enabled context, personality, Knowledge Base, web-search setting, provider, and model.
The health instruction remains the same. The transport can add a short private-mode note and changes how the request reaches the provider. See [Privacy and data storage](/guides/privacy) for the exact boundary.
No developer health prompt is added for voice transcription or speech synthesis. Those services receive the recording or text-to-read together with their selected voice settings. They can use a different provider from chat.
## Report or propose a change
If an instruction looks unclear, biased, unsafe, too broad, or inconsistent with the feature:
Say what you clicked or what feature ran, such as **Ask AI on a marker** or **Import report photos**.
Use the relevant **Read** link above so reviewers can find the maintained wording quickly.
Explain the behavior you saw, what you expected, and why the wording may have contributed.
Replace health values, names, report text, credentials, private Knowledge Base content, and other identifying information with made-up examples.
Use the [GitHub issue tracker](https://github.com/elkimek/get-based/issues). Maintainers can follow the [technical prompt review workflow](/developers/system-prompts#review-workflow).
Never paste an API key, share password, OAuth token, Cashu token, raw health report, or identifiable medical record into a public issue.