Smart Notes fills in your forms from a recorded conversation. If a draft leaves out detail, puts information in the wrong field or is shorter than you expect, the cause is usually the form set-up, not the recording.
This article shows you how to fix that yourself, using examples of forms your team is already happy with.
This method is sometimes called "few-shotting". It means you show the AI a few real examples of good answers, instead of only telling it what to do.
How Smart Notes fills a form
You record the conversation in the ACP mobile app.
The recording is turned into a written transcript.
The AI reads the transcript and your form, including a hidden instruction on each question called Smart Notes metadata, and drafts the answers.
You review the draft, edit it and submit.
The Smart Notes metadata tells the AI what belongs in each field. If it is generic, for example "Describe the client's social background", the AI has to guess what good looks like. When you rewrite it to describe how your team actually writes that answer, the drafts get closer to what you expect.
Before you start
You need Tenant Administrator rights to edit forms in the form builder.
Choose one form to work on first. Start with the form your team uses most with Smart Notes.
If you have not done so already, run the AI Form Optimiser on the form. It gives each field a sensible starting point. The steps below then tune it to your own style.
Step 1: Choose three to five good examples
Find three to five completed submissions of the same form that you are happy with, ideally from the last three months. Paper or digital is fine. For each question, look at how your team writes the answer:
How long is it? A few words, a sentence or a paragraph?
How is it structured? For example, a list, or one topic per line.
What level of detail does it include?
What words and phrases does your team use?
Step 2: If a draft went wrong, check the transcript
If you are fixing a specific draft, compare it with the recording transcript first. This tells you whether the form set-up can fix the problem.
Open the service.
Open the service user's case record.
Go to the History tab.
Open Smart Notes transcripts and find the log for that submission.
For each wrong or missing field, find what was said in the transcript:
The transcript has the wrong words. Changing the form will not fix this. See the recording tips below.
The transcript is right, but the answer is in the wrong field or has changed meaning. Update the metadata on both fields: the one it went into and the one it should have gone into.
It was said, but the draft left it out or shortened it. Update the metadata to ask for that detail. Also check whether a show/hide rule hides the field.
One answer covered two questions (for example "both"). Ask one question at a time, and tell Smart Notes to leave the field blank when the answer is not clear.
It was never said. This is not a Smart Notes fault. Cover that topic in the next conversation.
Step 3: Write the new Smart Notes metadata
For each field you want to improve, write a short instruction that describes the pattern from your good examples. Follow these rules:
Keep it to 500 characters or fewer. The form builder stops you at 500.
Use one line only. Use " / " where you want a new line.
Say what the field captures, how much detail to include and the format.
If two fields often get mixed up, say what does not belong in this field. For example: "Deliveries are not an access arrangement."
For Yes/No fields, say: "Select Yes only where clearly stated. If not stated, leave blank. Do not assume No."
When the client explains something themselves, ask for it to be recorded as "[Client] reports...".
You can include a short example, but use [Client] instead of names. Never include names, dates, addresses, phone numbers or key safe codes.
End with: "Use only what the speaker states. Never invent."
Example
Before: Describe the client's daily routine.
After: Record the morning routine in time order: call time, wake time, then each task in the order done, with where items are kept / Use short sentences, one task per line / Include preferences the client states / Use only what the speaker states. Never invent.
Step 4: Apply and test
Open the form in the form builder.
For each field, open it, go to Field Settings and replace the Smart Notes metadata with your new text.
Save the form.
Record a short practice conversation of about two minutes that covers the fields you changed, and check the draft.
Change a few fields at a time and test each round. This makes it easy to see what helped.
Optional: use Evo Researcher to draft the metadata
If your organisation has Access Evo Everywhere, Researcher can study your good examples and draft the new metadata for you. Attach your example forms (with personal details removed) and use a prompt like this:
Study these completed forms. For each question, describe how the answers are written: length, structure, level of detail and wording. Then write new Smart Notes metadata for each question that would benefit. Each value must be 500 characters or fewer, on one line, end with "Use only what the speaker states. Never invent." and contain no personal data. Return a table: question, reason for change, new metadata, character count.
Check every value against the rules in Step 3 before you apply it. Only use AI tools your organisation has approved. Never paste care records into a public AI tool.
Tips for better recordings
Ask one question at a time.
Repeat key answers back, for example "So glasses, but no hearing aids."
Say the topic before you start it, for example "Now medication."
Finish with a one-minute spoken summary of the main points.
Pause the recording while you sort paperwork or medication.
Need more help?
If you have followed these steps and drafts are still not right, contact our support team through the digital assistant in the bottom right of Care Planning.
Tell us which form and which fields are affected.
If you would like one-to-one help to set up your forms, ask your account manager about a session with our onboarding team.
