YaqeenDocs
Back to Yaqeen

Explanation

AI and your data

What the assistant sends to a language model, how Yaqeen's own redacting gateway changes it first, and what the gateway cannot catch.

Yaqeen has two AI parts. The fraud score recommends holds. The assistant, YQN, answers staff questions about holds, cases and appeals. This page covers the assistant and the data that could leave Yaqeen when it talks to a language model. The score is covered in How Yaqeen decides.

Where the model is used#

A built-in rules engine answers most questions. It maps a message to a lookup and writes the reply from templates, and it sends nothing anywhere. A language model answers only what the rules engine does not understand, and only when a model provider has been set up for your deployment over an encrypted (https) connection. There is no default provider and no fallback provider, so with none set up, nothing is sent.

The gateway#

Every request to a model passes through a gateway that is part of Yaqeen itself. It cannot be switched off. Before a request leaves, the gateway:

  • Replaces names, store names and staff usernames found under known fields with placeholders such as [PERSON_1].
  • Replaces anything shaped like an email, a phone number (Saudi or international, Arabic digits included), an IBAN, a national ID, a web address or a 64 character hash.
  • Withholds the free text that people typed (notes, statements, case comments) unless sending free text has been allowed for your deployment. Even then, the patterns above are swapped out.
  • Swaps the signed-in person's own username too.
  • Sends earlier replies in the chat only in their placeholder form, saved with each reply, never the text with the real names put back. A reply saved before this form existed is left out.

When the model answers, the gateway puts the real values back into the text the signed-in person reads. It does the same for any lookup the model asks for, so the lookup runs on the real value. The map between placeholders and real values lives in memory for one reply. It is never stored and never logged.

What the gateway cannot catch#

  • A name written inside free text that was allowed through, or inside the person's own message, when no pattern surrounds it.
  • Meaning. A sentence such as "the owner of the shop near the stadium" holds no pattern but may point at someone.

Redaction lowers what a provider sees. It does not make data anonymous, and it does not replace a contract. Before real data, a provider must sign a data processing agreement, promise not to train on inputs and say where it processes. It also goes on the sub-processors list first.

Connecting your own AI client#

A reviewer or admin can connect Claude or Codex to Yaqeen over MCP (Connect Claude and Codex). The connection is read-only. By default it does not pass through the gateway above. What the client looks up reaches it as the person could see it in Yaqeen, with names and amounts, and then goes to that client's provider under the customer's own agreement. Yaqeen does not control that provider. An admin can switch MCP off for the whole organisation, or turn on redaction, which swaps names, usernames and contact values for placeholders with the same redactor. Redaction is off by default. A redacted client cannot send a placeholder back, so it looks things up by id. Both settings are in PUT /api/v1/mcp/settings/ and each change is written to the audit log.

What the assistant stores#

Your messages and its replies are stored so you can see your own history. A person keeps at most 30 chats, and chats older than 90 days are deleted by the retention sweep. You can delete any chat yourself. Usage rows store tool names, counts and token numbers, never a message or a result.

What the assistant cannot do#

It takes no password, creates no account, deletes nothing and runs no SQL. It reads only what your role allows. After it has read text from outside (a note, a statement), it cannot propose a change in that reply. A change always arrives as a confirm card with a signed id that lasts 10 minutes and works once.

Up Down to moveEnter to openEsc to close