> For the complete documentation index, see [llms.txt](https://docs.welkinhealth.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.welkinhealth.com/care/ai-assistant.md).
# AI Assistant
Welkin's AI Assistant lets care team members ask natural-language questions about a patient and get answers grounded in that patient's full care record — without leaving the patient profile.
### Where to find it
Open a patient's profile and click the AI Assistant icon in the top-right toolbar. A panel opens on the right labeled **"Ask about \[Patient Name]"**, showing the patient's age and a **"Based on full care record in Welkin"** label.
The panel offers:
* **Suggested queries** — quick-start prompts such as "How is \[Patient] responding to the program?", "When was last contact and what was discussed?", "Summarize recent encounters," and "Draft a check-in message."
* **A message box** — type a free-form question, attach a file, or use voice input.
* An **AI Privacy** link and **"AI-generated answers may be inaccurate."** notice at the bottom of the input area.
The assistant reads from the same live Welkin data as the rest of the profile — encounters, assessments, communications, tasks, and more — so its answers reflect the patient's current record rather than a static snapshot.
### AI Privacy disclosure
At the bottom of the AI Assistant input panel, a short disclaimer appears: **AI Privacy · AI-generated answers may be inaccurate.**
Clicking **AI Privacy** opens a modal titled **"How Welkin AI works"** that explains:
* **Grounded in your patient's record** — Responses are generated from the patient's care record in Welkin: care program steps, encounters, assessments, CDTs, messages, and activity history.
* **Built to assist, not replace** — AI-generated content is intended to assist workflows only.
* **The provider stays in charge** — Clinical decisions remain the responsibility of the provider.
Click **Got It** or press **Escape** to close the modal.
{% hint style="info" %}
This chat panel is a different feature from the [AI Data View](/care/data-views/ai-widget.md) widget, which is a passive AI-generated summary card an administrator places on a dashboard. AI Assistant is the interactive, on-demand chat available from any patient profile.
{% endhint %}
### Voice input availability
The microphone (voice input) button in the AI Assistant message box is only active when the configured AI provider supports speech-to-text. If your organization's AI provider does not support transcription, the button appears grayed out and hovering over it shows the message **"Voice input is unavailable for the configured AI provider."**
If you expect voice input to be available but the button is disabled, contact your administrator to review the AI Assistant configuration in the Admin Portal.
### Panel behavior when a drawer is open
When a drawer opens on the patient profile (for example, a document, assessment, or detail drawer), the AI Assistant panel automatically shifts to the left to stay visible and avoid overlapping the drawer. This happens without any action required from you. When the drawer closes, the panel returns to its default position.
### Enabling AI Assistant for your organization
AI Assistant is a licensed add-on, turned on per organization — it is not available by default. To enable it, contact your **Welkin Implementation Manager or Customer Success Manager (account manager)** and request that the **Welkin AI** license be turned on for your org.
Once the license is active, an administrator connects it to an AI provider from **Admin Portal → Integrations → Welkin AI**. Each environment (instance) needs its own configuration and an API key, sourced one of two ways:
| Key source | Description |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Your own provider key** (Key Origin: `CUSTOMER`) | Your organization supplies an API key for a supported provider (OpenAI or Anthropic) and Welkin uses it for your AI features. This is the default for standard configurations. |
| **Welkin-managed key** (Key Origin: `PLATFORM`) | Welkin supplies and manages the underlying key on your behalf. Ask your account manager whether this option is available under your contract. |
See [AI Assistant (Admin)](https://docs.welkinhealth.com/admin/apis-and-integrations/ai-assistant) for the full configuration steps, supported providers and models, and speech-to-text setup.
### Related Topics
* [AI Data View](/care/data-views/ai-widget.md) — the AI summary widget on patient dashboards
* [AI Assistant (Admin)](https://docs.welkinhealth.com/admin/apis-and-integrations/ai-assistant) — configuring the AI provider and reviewing the audit log
---
# 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://docs.welkinhealth.com/care/ai-assistant.md?ask=&goal=
```
`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.
