Appearance
AI summary
The AI summary is a few short paragraphs that put an application's score into words: what raised it, what lowered it, and what the decision lines say. An outside AI service writes it when a person asks for it.
It is off until an administrator of your organization switches it on. It decides nothing: it never changes a score, a grade, a status or a decision, and the screen says so under every summary: "Written by an AI service from the score. It can be wrong and it does not decide anything." Read it as a reading aid, not as a recommendation.
What is sent, and what never is
Nothing is sent until someone selects Write a summary on an application. Then this goes to the service you chose, under your organization's own account with that service:
| Sent | Never sent |
|---|---|
| The ruleset's name and version | Names of the buyer, co-buyer, salesperson or any user |
| The grade, the total score and the section totals | Addresses, phone numbers, e-mail addresses |
| The decision lines (rate, term, down payment and so on) | Dates of birth and Social Security numbers |
| The payment figures: gross and net monthly income, the payment share and the highest payment | Employer names |
| For each scored question: its label, the chosen answer and its points | Notes, comments and files |
| With a co-buyer: whether the buyer, the co-buyer or both were scored, and the co-buyer's answer where it differs | The ids of the customer and the application, and your organization's name |
| Fixed instructions to summarise and not to recommend | The status and the tags |
A typed answer is sent as "(text)", never as what was typed. On every application, What is sent opens the exact list for that application before you send anything.
The service bills your organization's account for each summary. What the service does with what it receives is set by your agreement with that service, so read its terms before you switch this on.
Steps
Switch it on (organization administrator)
- Get an API key from the AI service your organization has an account with.
- Open Modules & apps → Tenant Modules and select Settings on the SAWScore card.
- Under AI summary: service choose
anthropic(Anthropic),openai_compatible(any service that speaks the OpenAI chat format) orgemini(Google Gemini). - Fill in AI summary: model with the model name exactly as the service gives it. For Anthropic you can leave it empty to use the default the field's description names.
- Only for
openai_compatible: fill in AI summary: service address, for examplehttps://api.openai.com/v1. It must start withhttps://and be on the public internet. - Paste the key into AI summary: API key. It is stored encrypted and is never shown again.
- Switch on AI summary: switch on and select Save.
Changing the service address clears the stored key, so enter the key again in the same save. To stop using the feature, switch AI summary: switch on off. Summaries already written are kept with their applications, but the card that shows them is hidden while the feature is off.
Ask for a summary
- Open an application and select the Decisions tab. The AI summary card is below the score.
- Select What is sent if you want to check first.
- Select Write a summary. "Asking the AI service. This can take up to half a minute."
- Read the summary. Under it you see who asked for it, when, and which service and model wrote it.
Write again replaces the summary; Remove deletes it. Writing needs the permission to create and edit applications or to change status. People with the sales queue only never see the card.
What happens next
- The summary is kept with the application, and the application's Activity records that one was written or removed. The revision number does not move.
- When the application changes afterwards, the summary stays but is marked "Out of date: the application changed since this summary".
- While the feature is off, people with the settings permission see "The AI summary is off. An administrator can switch it on in the module's settings." on the Decisions tab. Everyone else sees nothing.
If something goes wrong
| You see | It means | Do this |
|---|---|---|
| "The AI summary is switched on, but its settings are not complete. No API key is entered." (or model, or address) | A setting is missing. Write a summary is unavailable. | An administrator completes the settings. |
| "This application has no saved score yet." | There is nothing to summarise. | Save the application first. |
| "Your organization has reached the limit of 30 AI summaries per hour. Try again in about … minutes." | The limit counts every attempt, also failed ones. | Wait. |
| "The AI service did not accept the API key. An administrator can check it in the module's settings." | The key is wrong or was revoked. | Enter a valid key. |
| "The AI service does not know this model or address. An administrator can check them in the module's settings." | A typing mistake in the model name or the address. | Correct it. |
| "The AI service is limiting requests for this account. Try again later." | The service's own limit for your account. | Check your account with the service. |
| "The AI service could not be reached. Try again later." | No answer within 30 seconds, or a network problem. | Try again. |
| "The address of the AI service is not allowed. It must be a public https:// address." | The service address points at a private or local host. | Use the service's public address. |