Guide
How Agent1000 works inside a South African public institution, and what an official is agreeing to when they let an agent in.
On this page
Overview
What Agent1000 is
Agent1000 is an AI workforce for national and provincial departments, public entities, municipalities, universities, science councils and SETAs. It takes the administrative work every institution runs on — leave applications, travel claims, budget certificates, contract instructions, the monthly budget report — and does it inside the systems the institution already runs, from Persal to the registry mailbox.
What makes it usable in the public sector is where it stops. An agent prepares; a named official decides. Nothing is captured, sent, published or changed on its own, and every approval is recorded against the person who gave it. That is what lets the decision survive an audit, not just a demo.
Agents
Each agent takes one workflow — leave, claims, the budget, contracts — or one standing job such as patching or publishing, and is named for it. Its page in the catalogue says what it connects to, how you reach it, and exactly what a person approves.
| Agent | What it does |
|---|---|
| People and HR | |
| LeaveDesk | Checks each leave application against the leave determination and the balance on Persal, and routes it to the line manager and HR. |
| Finance and claims | |
| ClaimsDesk | Builds travel and kilometre claims from the approved trip, checks every receipt against the rates in force, and pre-reviews each claim for Finance. |
| BudgetDesk | Loads the monthly expenditure extract, raises the exceptions, and checks each budget confirmation request against the available balance. |
| Security and patching | |
| VulnWatch | Checks the software behind an institution's custom applications every day and reports what needs patching, most urgent first. |
| SiteWatch | Watches an institution's public websites for downtime, expiring certificates and changed pages, and says which one broke. |
| Publishing and content | |
| ContentDesk | Turns an emailed request into a web page, and holds it until the officer who asked for it approves the preview. |
| Documents and records | |
| RecordsDesk | Files incoming correspondence against the right case record and tells the registry clerk what it filed. |
| MinuteDesk | Will turn a meeting recording into minutes in the institution's own format, for the secretariat to correct and circulate. |
| Data and reporting | |
| ReportPack | Assembles the same monthly reporting pack from the same sources each month and sends it to the responsible manager to sign off. |
| Service desk | |
| DeskTriage | Will read incoming service desk mail, sort it by what it is about, and draft the first reply for an agent to send. |
| Compliance | |
| ContractDesk | Checks a contract drafting instruction for completeness and the signatory's delegation of authority, and tracks each drafting stage against its turnaround. |
| TenderCheck | Will check a tender pack for missing mandatory documents before it reaches the bid committee. |
| PolicyWatch | Will track changes to the regulations an institution reports against and tell the compliance officer what changed. |
Setting up an agent
An agent is set up for your institution, not downloaded. Before it does any work, three things are settled with you:
- The workWhich workflow it takes on, and on what rules: the leave determination, the travel rates and limits in force, the turnaround for each stage.
- The approversThe chain as your institution runs it: line manager and HR for leave; Finance and the supervisor for claims; the delegated official for a contract. The agent sends every binding action to them, and to no one else.
- The accessIts own account in each system it needs — Persal, the document store, the mailbox — with the permissions that job requires and nothing more.
Threads
Each piece of work is a thread: one conversation that holds the request, what the agent did, what it is waiting for and who it is waiting on. Start a new thread for each task rather than running unrelated work through one long conversation.
Keeping the work apart keeps the record readable. A leave application, a travel claim and a budget certificate each have their own thread, so when someone later asks how a claim came to be paid, the trip, the receipts, Finance’s findings and the supervisor’s approval are in one place. A claim sent back for rework stays in the same thread, under the same reference, so the second round can be read against the first.
Memory
An agent learns from its work across all of its threads: the conversations, and the documents and attachments it handled. What it learns in one thread helps in the next — which supervisor signs for which unit, the receipts Finance has queried before, the clauses legal services always asks for — and it can look back at earlier threads when it needs more context.
Memory builds in the background, so there is nothing to manage day to day. It stays with the agent it belongs to; one agent’s memory is not shared with another. And it never stands in for an approval: an agent that has seen a hundred clean claims from the same official still sends the hundred-and-first to Finance.
Sharing an agent
An agent starts with the officials named when it is set up, and more can be added as the work needs them. Everyone working with an agent sees its threads, so a colleague can pick up a task where someone else left it, and a manager can see what is waiting and on whom.
That is how the work is already split. A capturer can prepare a claim for an official who then signs it themselves. A supervisor going on leave can delegate their approvals for a week; the delegate signs “on behalf of”, and the record says so.
Sharing an agent does not share its approvals. Only the officials named as approvers can sign off its work, and every approval is still recorded against the person who gave it.
Workflows
These are the workflows an institution runs every week, and where an agent fits in each. In every one, the agent does the checking, the routing and the chasing. The signatures stay with the officials who hold them today.
| Workflow | What the agent does | Who signs off |
|---|---|---|
| Human resources | ||
| Leave applicationLeaveDesk | Checks the application against the leave determination and the balance on Persal, asks for the missing certificate, and routes it. | Line manager, then an HR practitioner for the head of department. Captured on Persal only after both. |
| Profile change request | Takes the change and its evidence, and sends it to the right reviewer for that field. | The line manager or HR, depending on the field. |
| Finance | ||
| Travel claimClaimsDesk | Builds the claim from the approved VA26A trip, applies the rates in force, light-checks each receipt, and pre-reviews it for Finance. | The claimant signs, Finance verifies, the supervisor approves. Then Persal capture and the BAS form. |
| Kilometre claimClaimsDesk | Checks the month’s trip log against the map estimate and flags private travel. | The claimant signs, Finance verifies, the supervisor approves. |
| Budget confirmation certificateBudgetDesk | Derives the segment codes and checks the available balance before the request goes anywhere. | Responsibility manager, then the budget office, then the state accountant issues it. |
| Monthly budget vs spendingBudgetDesk | Loads the month’s expenditure extract, raises the exceptions, and asks each programme manager for their variance reasons. | Programme managers explain their lines; the responsible manager signs off the report. |
| Legal and contracts | ||
| Contract drafting instructionContractDesk | Checks the instruction is complete and the signatory sits within the delegation of authority, and tracks each stage against its turnaround. | Legal services manager, then the head of legal services. Signed by the delegated official. |
How a task runs
Every task follows the same four steps, in the same order.
- AskSay what you need done, in the words you would use with a colleague. No forms, no scripting, no new system to learn.
- ConnectThe agent works inside the systems the institution already runs: Persal, the mailbox, the document store, the finance system.
- ApproveEvery binding action stops and waits for a named official. The agent says what it wants to do, and to whom it has sent it for a decision.
- RepeatSay “do this every Monday” and the one-off becomes standing work. The approval step comes with it.
What an ask looks like
“Process the leave request from employee 4471, 5 days annual leave, 22 to 26 September.”
“Start my travel claim for the Polokwane trip.”
“Where is the contract instruction for the bursary partnership, and who is holding it?”
You can watch a leave request run, approval gate and all, on the front page.
Channels
You reach an agent through channels the institution already uses. Which ones depends on the agent.
| Channel | How it is used | Agents |
|---|---|---|
| Ask and approve from a phone. Useful for the official who signs off between meetings, not at a desk. | VulnWatch, ContentDesk, SiteWatch, LeaveDesk, ClaimsDesk, DeskTriage | |
| Write to the agent the way you would write to a colleague. Previews, reports and approval requests come back to your inbox. | VulnWatch, ContentDesk, RecordsDesk, ReportPack, SiteWatch, LeaveDesk, ClaimsDesk, BudgetDesk, ContractDesk, TenderCheck, DeskTriage, PolicyWatch, MinuteDesk | |
| Web console | A web view of the agent's work: what it has prepared, what is waiting for whom, and what it has done. | RecordsDesk, ReportPack, LeaveDesk, ClaimsDesk, BudgetDesk, ContractDesk, TenderCheck, DeskTriage, MinuteDesk |
Automations
An automation is a task that starts on its own: at a set time, or when something arrives or changes. You set one up by saying it in the thread, in plain language.
“Remind me a week before any claim deadline.”
Types of automations
| Automation | How it works | For example |
|---|---|---|
| Schedule | Runs at times you choose: every weekday morning, every Monday, the first working day of the month. |
|
| Deadlines | Counts due dates in working days, skipping weekends and public holidays, and acts when one is close or passed. |
|
| Runs when mail arrives in a mailbox the agent watches, such as an HR, finance or registry mailbox. |
| |
| Email replies | Reply to the agent’s own emails to answer a query, add a missing document or ask a follow-up. |
|
| Talk to an agent’s threads from a phone: ask, check what is waiting, and send a document from where you are. |
| |
| Web console | Start a task, and see what the agent has prepared and what is waiting on whom. |
|
| Status changes | Runs when a request moves on: approved, sent back for rework, or captured. |
|
Approvals
Every agent has one of two approval modes. Neither lets an agent make a binding change on its own.
| Mode | What it means | Agents |
|---|---|---|
| Every action approved | Every piece of work stops for a named person before it takes effect: each page, each filing, each reply. | ContentDesk, RecordsDesk, LeaveDesk, ClaimsDesk, BudgetDesk, ContractDesk, TenderCheck, DeskTriage, MinuteDesk |
| Approve once, then runs | A responsible official approves the job once — scan and report, watch and report, assemble the pack. Anything that changes a system still waits for a person. | VulnWatch, ReportPack, SiteWatch, PolicyWatch |
Who approves what
- VulnWatch: Standing approval to scan and report; an administrator approves each change before anything is patched.
- ContentDesk: The requesting officer approves the preview; nothing goes live until they reply.
- RecordsDesk: A registry clerk confirms the case record before anything is filed against it.
- ReportPack: The responsible manager signs off the pack; the agent assembles it and never submits it.
- SiteWatch: Standing approval to watch and report; an administrator approves any change to a site.
- LeaveDesk: The line manager recommends and an HR practitioner approves; leave is captured on Persal only after both.
- ClaimsDesk: The claimant signs, Finance verifies and the supervisor approves before anything is captured for payment.
- BudgetDesk: The responsibility manager, the budget office and the state accountant each sign a certificate in turn; the responsible manager signs off the monthly report.
- ContractDesk: Legal services reviews every draft, and only the delegated official signs the contract.
- TenderCheck: A supply chain officer will review every flag before it is put to a bidder.
- DeskTriage: A service desk agent will send every reply; the agent will draft and never send.
- PolicyWatch: The compliance officer will decide what action a change requires.
- MinuteDesk: The secretariat will approve the minutes before they are circulated.
Standing work
Most work in an institution is not a one-off. Once a task has run, one sentence turns it into standing work:
“Do this for every leave request that comes in.”
“Start the budget report on the first working day of every month.”
The approval step is part of the task, so it is part of the standing work too. Every leave request still goes to the line manager, and the monthly report still goes to the responsible manager; neither is ever approved or submitted for them.
| Cadence | What it means | Agents |
|---|---|---|
| On a schedule | Runs at a set time — every weekday morning, the first working day of the month. | VulnWatch, ReportPack, SiteWatch, BudgetDesk, PolicyWatch |
| On request | Runs when someone asks: an email arrives, a request comes in. | ContentDesk, RecordsDesk, LeaveDesk, ClaimsDesk, ContractDesk, TenderCheck, DeskTriage, MinuteDesk |
Governance
The agent's own account
An agent signs in as itself: its own account, with its own permissions, in the systems you already run. It never borrows an official’s login.
That keeps the controls you already have in charge. You decide what the account may see and touch, you can see what it touched, and you can take the account away in an afternoon.
Binding actions
A binding action is anything that commits the institution: capturing leave on Persal, verifying or paying a claim, issuing a budget certificate, signing a contract, sending a letter, publishing a page. The agent prepares it; a named official decides. That order is not configurable.
When an agent is unsure — a receipt in someone else’s name, a sick note that does not cover the first day — it stops and says so rather than guessing.
The approval record
Every approval is logged against the official who gave it, not against the agent. When the Auditor-General, an internal audit committee or a manager asks who authorised a change, there is a person’s name to give them.
Institutions
Who it is for
Agent1000 is written for the institutions the PFMA and the MFMA already name. The catalogue filters by these classes, so you can see the agents whose work exists in an institution like yours.
| Tier | Class | Covers |
|---|---|---|
| National | National department | The 30-odd national departments |
| National public entity | PFMA Schedule 3A and 3B | |
| Government business enterprise | PFMA Schedule 2, the major SOEs | |
| Constitutional institution | Chapter 9 bodies and legislatures | |
| Provincial | Provincial department | Provincial equivalents across the nine provinces |
| Provincial public entity | PFMA Schedule 3C and 3D | |
| Local government | Metropolitan municipality | The eight metros |
| District municipality | The 44 districts | |
| Local municipality | The 205 locals | |
| Municipal entity | MFMA-governed entities owned by municipalities | |
| Education, science and skills | Higher education institution | Universities and TVET colleges |
| Science council | CSIR, HSRC, MRC and the rest | |
| SETA | The 21 sector education and training authorities |
Partners
Resellers and integrators
Agent1000 is sold and connected through appointed partners. A partner holds one role or both, and the roles answer different questions: who holds your contract, and who touches your systems.
| Role | What they do |
|---|---|
| Reseller | Sells and holds the agreement. Your contract is with them, and they carry first-line support. |
| Integrator | Connects agents to your systems. Works to your change control, alongside your own IT. |
A company that wants to become one can apply as a reseller. Every applicant is vetted before they are appointed.
Checking a partner
Before you give a company access to your systems on our behalf, check it on the partner register. Every appointed partner is listed there with its roles, the agents it is certified on, the dates of its appointment, and a certificate number you can quote back to us.
- Ask the company for its certificate number.
- Find the company on the register and compare the number.
- Check that it is certified on the agent it is offering, and that the appointment has not lapsed.
Getting started
Your first task
- Describe the workPick the work that eats a morning every week and describe it. You will see which agent comes closest.
- See it runRequest a demo. We show you the agent doing that work, and exactly where it stops for an official.
- Decide who approvesName the officials who will sign off: line managers and HR practitioners, finance officers and supervisors, the responsible manager.
- Connect and startThe agent gets its own account in your systems, connected by your IT or a certified integrator. Its first task waits for its first approval.