العربية — This page is not in Arabic yet. Opens the Arabic home page.

Start free trialBook a demo

Browse the documentation

Documentation

All appsHow the apps connectTeam workflowsCompare

Apps

HR ManagementRecruitment (ATS)Payroll & WPSTime & AttendanceAccounting & E-InvoicingCRM & Sales PipelineSales Orders & FulfilmentInventory, Purchasing & WarehousingProcurement & TendersConstruction & ContractingContracts & E-SignatureProducts & Online StorePoint of SaleRentalsSubscriptions & LicensingHelpdesk & TicketingSocial Media SuiteInfluencer Marketing & Campaign ROIProject ManagementActivities WorkspaceDocument ManagementPDF Tools & E-SignatureCorrespondence RegisterTeam Chat & CallsMeetings & VideoLearning & Certification (LMS)Asset ManagementFleet ManagementRecognition & GamificationContacts & PartnersNotification CentreReports & DashboardsInsights — Business Intelligence & AppsAI CopilotAI Agents & AutomationAI Diagram StudioWebsite BuilderISO Compliance Suite (Imtithal)App MarketplaceCustomer & Partner PortalSecurity, Access & Compliance

the assistant role guides — what each role can do, step by step

How anybody at work asks a question and gets an answer from the company's own data — and how an administrator chooses the provider, holds the key and reads the bill. 9 steps across 2 roles, every one of them carried out in the product before it was published here.

Last updated

Nothing matches that. Try a shorter word, or pick All roles to search every guide.

Go deeper

Anyone at work

Ask in your own words. Get an answer from your company's own data.

Ask a question in your own words and get an answer from your company's own data — inside whatever you can already see.

What you will be able to do

  • Open the assistant from any page without losing your place
  • Ask about what is on the screen in front of you
  • Get an answer built from your data, not from the internet
  • Have it do the small thing you were about to do by hand

What this role can and cannot do

CanCannot
  • copilot:chat
  • ai:text:assist
  • Nothing in this list is closed to this role.

5 steps, each one carried out in the product on .

Check that the assistant is yours to use #

Where Your name, top right » Profile

  1. Open your company's address in the browser — it looks like yourcompany.tarleaks.com.
  2. Type the e-mail address your administrator set up for you, then your password.
  3. You land on the app launcher: a grid of the apps your company uses.
  4. Click your name, top right.
  5. Choose Profile.
Screenshot: Check that the assistant is yours to use, Anyone at work view
Nothing here needs to say 'copilot' — everybody has it.

You should see No special role is needed. Everybody can ask; what comes back depends on what that person is allowed to see.

Watch out What comes back is limited to what YOU may see. Two people asking the same question can get different answers, and that is correct.

Open the assistant from wherever you are #

Where Any page » the assistant button, bottom right

  1. Open any page with a list on it.
  2. Click the round assistant button in the bottom-right corner, or press ⌘J.
  3. Type a question in your own words and press Enter.
Screenshot: Open the assistant from wherever you are, Anyone at work view
The button sits above the page, bottom right, and the panel opens over the page rather than replacing it.

You should see It opens over the page you were on, so you do not lose your place — and it already knows which screen you were looking at.

Watch out Ask about what is in front of you. 'Who is on leave next week' works; 'what is our strategy' does not, because that is not in the data.

Worth knowing Ask about the screen you are on: 'who is on leave next week', 'which of these is overdue'. It reads that page's data.

Use the full assistant page for a longer session #

Where Assistant

  1. Open Assistant from the launcher.
  2. Ask a longer question, or one that needs a table or a chart.
Screenshot: Use the full assistant page for a longer session, Anyone at work view
Room for the answer, the table it built and the chart it drew.

You should see The same assistant, with space to read a table or a chart it produced.

Get AI writing help inside a text field #

Where My requests » New request » Description

  1. Open My requests and press New request.
  2. Type in Description.
  3. Press the sparkle at the field's corner (or Ctrl J / ⌘J).
Screenshot: Get AI writing help inside a text field, Anyone at work view
A menu under the field: a box to type your own instruction, then Edit, Change tone and Transform.

You should see The menu opens under the field: Improve writing, Fix spelling & grammar, Make shorter, Make longer, Continue writing and the tones at the top; scroll it for formal Gulf business Arabic, Summarize, bullet points and translation between English and Arabic — or type what you want in the box at the top and press Enter.

Watch out Inside a text field Ctrl J opens writing help for that field; anywhere else it opens the assistant.

Worth knowing Fields that hold a password, a key, a card or an identity number never show the sparkle.

Check the suggestion, then accept it #

Where My requests » New request » Description » Fix spelling & grammar

  1. Pick an action.
  2. Read the suggestion.
  3. Press Accept, or Discard.
Screenshot: Check the suggestion, then accept it, Anyone at work view
The suggestion under the field, marked AI-written, with Accept, Insert below, Try again and Discard.

You should see Your field does not change until you press Accept, and the suggestion keeps your names, numbers and dates exactly as you wrote them.

Watch out If the suggestion adds a link, a number or an address that was not in your text, it says so in red before you accept.

Use cases — the work, step by step

Each one is a sequence somebody actually performs, with the screen behind every step. Every screen here was opened in the product as this role before it was published.

dailyAsk about the screen in front of you #

The assistant already knows which page you are on, so the question can be as short as you would say it out loud.

  1. Open a page with a list on it — the people directory, for example.

    Anyone at work doing "Ask about the screen in front of you" in Tarleaks ERP — Open a page with a list on it — the people directory, for ex
    Any page » the assistant button, bottom right — verified: the page says “copilot”
  2. Press the assistant button (or ⌘J) and ask in your own words. The answer is built from the data you are allowed to see.

    Anyone at work doing "Ask about the screen in front of you" in Tarleaks ERP — Press the assistant button (or ⌘J) and ask in your own words
    Any page » the assistant button, bottom right — verified: the page says “copilot”
  3. For a longer session, or when you want a table or a chart with room to read it, open the full assistant page.

    Anyone at work doing "Ask about the screen in front of you" in Tarleaks ERP — For a longer session, or when you want a table or a chart wi
    Assistant — verified: the page says “Assistant”

dailyHave a rough note written properly #

A reason, a reply or a comment reads better in a few seconds, in English or formal Arabic — and nothing changes until you accept it.

  1. Type your note the way it comes to you, then press the sparkle at the field's corner (or Ctrl J).

    Anyone at work doing "Have a rough note written properly" in Tarleaks ERP — Type your note the way it comes to you, then press the spark
    My requests » New request » Description — verified: the page says “Improve writing”; the page says “Formal Gulf business Arabic”; the control is offered
  2. Pick Fix spelling & grammar, Improve writing or a tone. Read the suggestion and press Accept — or Undo if you change your mind.

    Anyone at work doing "Have a rough note written properly" in Tarleaks ERP — Pick Fix spelling & grammar, Improve writing or a tone. Read
    My requests » New request » Description » Fix spelling & grammar — verified: the control is offered; the page says “review before you save”

It can only see and do what YOU can. Ask it about a colleague's salary and it will refuse in exactly the same way the product would.

Tenant Administrator

Your AI, your provider, your key — and a bill you can read.

Chooses the AI provider, holds the key, and decides which parts of the assistant the company uses.

What you will be able to do

  • Choose the provider and the model the company uses
  • Keep the key in your own settings rather than ours
  • See what is being asked and what it costs
  • Switch parts of it off when you want them off

What this role can and cannot do

CanCannot
  • tenant:settings:write
  • Nothing in this list is closed to this role.

4 steps, each one carried out in the product on .

Choose the provider and the model #

Where Settings » AI

  1. Open Settings, then AI.
  2. Choose the provider, paste the key, pick the model.
  3. Save, then use the test button to prove it answers.
What each field wants
FieldWhat to put in it
ProviderWho runs the model — your company's account with them is what is used.
API keyYour key. It is stored encrypted and shown masked afterwards; saving without retyping it keeps the existing one.
Chat modelThe model used for questions. A bigger model costs more per question and is not always better at reading your own data.
LanguageArabic makes the assistant answer in Arabic — the prompts change, not just the interface.
Screenshot: Choose the provider and the model, Tenant Administrator view
Provider, key and model — the three that decide what the assistant runs on.

You should see The company's own account and key — the assistant runs on your contract, not on somebody else's quota.

Watch out Changing provider changes cost and tone. Test one question before telling the company it moved.

Worth knowing A saved key is shown masked afterwards, and saving without retyping it will not overwrite the real one.

Use the suggestions written for that screen #

Where Finance » any page » Ask the copilot

  1. Look above the list on a page — a row of suggested questions.
  2. Click one.
Screenshot: Use the suggestions written for that screen, Tenant Administrator view
The suggestions change per screen, because they are written for that screen's data.

You should see The suggestions are written for that screen's data and filtered by what you may see, so a prompt you would not be allowed to run is never offered. Today they are written for the finance screens; other modules use the assistant button instead.

See what it is being used for #

Where Settings » AI usage

  1. Open AI usage.
Screenshot: See what it is being used for, Tenant Administrator view
What was asked, by whom, and what it cost.

You should see You can answer 'what is this costing us' without opening a provider dashboard.

Watch out Usage climbing on one screen usually means the suggestions there are doing their job, not that somebody is abusing it.

See how the writing assistant is used, and set its limits #

Where Settings » AI usage limits » Writing assistant in text fields

  1. Open Settings, then AI usage limits.
  2. Scroll to Writing assistant in text fields.
What each field wants
FieldWhat to put in it
Requests per person per minute1 to 120; 20 to start.
Autocomplete requests per person per minute1 to 240; 40 to start.
Requests per minute for the whole company1 to 5000; 600 to start.
Longest answer (model tokens)128 to 4000; 1200 to start.
Screenshot: See how the writing assistant is used, and set its limits, Tenant Administrator view
Four numbers for the last 30 days, the people who used it most, and the four limits.

You should see Only counts are kept — never the text anybody wrote. The on/off switches for the assistant and for suggestions as you type are in Feature flags.

Use cases — the work, step by step

Each one is a sequence somebody actually performs, with the screen behind every step. Every screen here was opened in the product as this role before it was published.

yearlyPoint the assistant at your own AI account #

The key is yours, the bill is yours, and the assistant answers inside each person's own permissions either way.

  1. Open Settings, then AI, and choose the provider and model.

    Tenant Administrator doing "Point the assistant at your own AI account" in Tarleaks ERP — Open Settings, then AI, and choose the provider and model.
    Settings » AI — verified: the page says “provider”
  2. Paste your key and save. It is stored encrypted and shown masked afterwards.

    Tenant Administrator doing "Point the assistant at your own AI account" in Tarleaks ERP — Paste your key and save. It is stored encrypted and shown ma
    Settings » AI — verified: the page says “provider”
  3. Come back to AI usage after a week and read what it is being used for and what it costs.

    Tenant Administrator doing "Point the assistant at your own AI account" in Tarleaks ERP — Come back to AI usage after a week and read what it is being
    Settings » AI usage — verified: the page says “usage”

monthlyShow a team the prompts written for their screens #

A blank box is intimidating; a row of questions somebody already wrote is how people start using it.

  1. Open a finance page and read the suggestion strip above the list — the prompts are filtered by what the reader may see.

    Tenant Administrator doing "Show a team the prompts written for their screens" in Tarleaks ERP — Open a finance page and read the suggestion strip above the
    Finance » any page » Ask the copilot — verified: the page says “Ask the copilot”
  2. Check usage afterwards: a rise on one screen usually means the suggestions there are doing their job.

    Tenant Administrator doing "Show a team the prompts written for their screens" in Tarleaks ERP — Check usage afterwards: a rise on one screen usually means t
    Settings » AI usage — verified: the page says “usage”

monthlyKeep the writing assistant within limits #

Writing help is on everybody's text fields; a quick look each month shows who uses it and keeps the cost predictable.

  1. Open Settings, then AI usage limits, and read the Writing assistant card: requests, people, answered and answer time.

    Tenant Administrator doing "Keep the writing assistant within limits" in Tarleaks ERP — Open Settings, then AI usage limits, and read the Writing as
    Settings » AI usage limits » Writing assistant in text fields — verified: the page says “Writing assistant in text fields”; the page says “Requests per person per minute”
  2. Set the requests per person and for the whole company a minute, and the longest answer, then press Save limits.

    Tenant Administrator doing "Keep the writing assistant within limits" in Tarleaks ERP — Set the requests per person and for the whole company a minu
    Settings » AI usage limits » Writing assistant in text fields — verified: the page says “Writing assistant in text fields”; the page says “Requests per person per minute”

The assistant answers inside each person's own permissions, so switching it on does not widen anybody's access by a single record.