Documentation
Using ITAI
Everything you need to install ITAI, run your first diagnosis, and understand exactly what it can and can't do on your machines.
How ITAI fits together
ITAI has two parts. The dashboard is where your team opens tickets, reviews findings and approves fixes. ITAI on the PC is a small Windows service on each device: it checks in with the dashboard, runs the commands it's allowed to, and reports back.
A diagnosis is a conversation between the two. ITAI decides what to look at next, ITAI on the PC runs that one read-only command and returns the output, and this repeats until ITAI has a finding. Changes only happen after a person approves them.
Creating your account
Once sign-up is open, choose Create account on this site, or open app.itaibot.io/signup.html. Until then, choose Request early access. You give your name, your company, whether you manage IT for other companies (an MSP) or for your own company, and a work email address. Then:
- Two-step sign-in. You set it up straight away, with an authenticator app on your phone.
- Verify your email. We email you a link. Until you open it you can add PCs and open tickets, but AI diagnoses, adding funds and adding a card wait. The link lasts 24 hours; Resend the email is on the Devices page and under Billing.
- Install ITAI on a Windows PC from the Install page (see below).
- Turn on AI. Free for 30 days on your PCs. AI diagnoses use prepaid credit from $5. Add a card to keep going after 30 days. Add credit under Company settings, Billing.
MSPs: add each client as its own organization. Its PCs, tickets and people stay separate, and every organization is on your one bill.
To cancel, the account owner emails billing@itaibot.io. See Refunds and cancellation.
Requirements
- A company in the United States. ITAI is available in the United States only, for now.
- Windows 10 or 11, or Windows Server. macOS and Linux are on the roadmap.
- Administrator rights on the device, to install the service.
- Python 3.10 or newer, installed for all users. You don't need to install it first: if it's missing, the installer installs it (see below). It uses
winget, or python.org's official installer wherewingetisn't available, such as on Windows Server 2019. - Outbound HTTPS from the device to your ITAI dashboard. ITAI on the PC only makes outbound connections, so no inbound firewall ports are needed. Installation also downloads Python from Microsoft's
wingetor python.org, and Python packages from pypi.org.
Installing ITAI
Open Install in the dashboard. Every organization has its own installer, and a device joins the organization whose installer it ran. Each download carries its own enrollment key, which adds PCs for 7 days; download again for later installs.
Option 1: one line of PowerShell
Copy the command from the Install page and paste it into PowerShell opened with Run as administrator. It looks like this, with your organization's own values filled in:
powershell -ExecutionPolicy Bypass -Command "& { ... install.ps1 ... -ApiKey '<your org key>' -BackendUrl 'https://<your dashboard>' }"
Option 2: the installer package
Download the installer from the Install page and run it on the device as an administrator. Use this where copying and pasting a command isn't practical.
Either way, the installer checks for Python, writes the device's configuration and starts the ITAIReceiver service. The device appears in your dashboard within a minute of the installer saying it is done.
If Python is missing, the installer lists what it needs and asks before installing it (press Enter for Yes; no answer within a minute also means Yes). Pushed from an RMM tool or run as SYSTEM, where nobody can answer, it installs Python for all users without asking and says so in its output. Python comes from winget, or from python.org's official installer, checked before it runs. If you manage Python yourself, add -NoPrereqs to the command: the installer then never installs Python, and stops with instructions if it's missing. A progress bar, and a percentage on the output line for each step, show how far along it is.
Windows warnings, antivirus, firewalls, or a PC that never appears: see Installer troubleshooting, the same page as Help in the dashboard.
Your first ticket
- Open the device from Devices.
- Under Open a ticket, describe the problem the way a user would report it, for example "Printer shows offline for everyone on the second floor".
- Pick a privilege level. Local admin is the default and right for most problems.
- Choose Open ticket. You can watch each command and its output arrive live.
- When ITAI finishes, read the findings and the proposed fix, then approve what you're comfortable with.
Privilege levels
This is the one decision ITAI asks you to make on every ticket. It sets the account ITAI investigates and fixes things with on that device.
| Level | Use it for | Notes |
|---|---|---|
| Current user | Problems in one person's profile: an app setting, a mapped drive, a browser. | Can't see system-wide settings or other users. |
| Local admin | Most problems: services, drivers, updates, disk, network. | The default. |
| Domain service account | Problems that need domain permissions. | Not available yet. |
| SYSTEM | Deep system problems that local admin can't reach. | The highest privilege on the device. Needs an explicit confirmation each time. |
The privilege level is the account a fix you approve runs with. Investigation stays read-only at every level. From the next release of ITAI for your PCs (the one after version 1.0.0) every investigation step ITAI chooses runs with limited rights: no administrator rights and none of SYSTEM's access to files, and a check that would need full rights is not run; ITAI shows it for you to run instead. The exception is a short list of network, printer and disk status checks (network adapters, IP settings, routes, DNS client settings, connection tests, printers and print queues, disks, volumes and partitions), which runs with full rights. The checks ITAI runs after a fix use the same limited rights and the same list, so before and after compare like with like; only the check that a DNS record does not exist yet, before an approved fix adds it, runs with the fix's own rights. ITAI's own fixed inventory of the PC (hardware, network, disks and printers) still runs with the receiver's own rights. A PC still on version 1.0.0 investigates as the level you pick. On every version, local admin, which an approved fix can run as, has the same rights as SYSTEM.
Reviewing a proposed fix
A proposed fix is a list of steps. Each one shows the exact command, a risk rating, and a rollback command that undoes it.
- Open a step to review it. Only a step you have opened can be ticked.
- Approve selected steps runs only the steps you tick, in order.
- Anything you don't approve never runs. You can close the ticket and fix it by hand instead.
- Your approval is signed with your organization's key, covers only the commands you ticked on that device, is issued once and expires five minutes after approval. The device checks the signature against its copy of your organization's public key, and refuses any step that doesn't match.
- A step marked Not independently checked is one the second AI check couldn't assess. Read its command yourself: approving it records that you saw the warning.
- Fixes are on for a new client. If fixes are off for a client, the proposed fix can be read but not approved; an admin, or ITAI staff with a recorded reason, turns fixes on in Company settings.
Ticket statuses
| Status | Meaning |
|---|---|
| Queued | Waiting for the device to pick it up. |
| Running | ITAI is investigating. |
| Awaiting review | A finding and plan are ready for you. |
| Approved | Your approved steps are running. |
| Fixed, confirm with user | The approved fix ran and its checks passed. The ticket stays open until a technician checks with the user. |
| Resolved by ITAI | ITAI's fix worked, and a technician confirmed it with the user and closed the ticket. |
| Resolved manually | A technician fixed it and closed the ticket. |
| Self-resolved | The problem went away on its own. |
| No issues found | ITAI looked and found nothing wrong. |
| Unreachable | The device didn't respond. |
| Escalated | Needs a technician: ITAI couldn't reach a safe conclusion. |
| Restarting | An approved restart is under way; the fix carries on when the device is back. |
| Merged | Combined into another ticket. It stays readable on its own page. |
Managing devices
Retiring and restoring
Retire a device you've replaced or decommissioned. It leaves the main list, stops counting toward per-device billing, and can't be targeted by tickets. Restore it at any time. Devices that stop checking in are retired automatically after 30 days, and one that checks in again comes back by itself.
Device profile
Each device reports its make, model, serial number, OS and build, hardware and network identity. It's refreshed every hour, and at the start of a diagnosis when it is more than ten minutes old.
Organizations & keys
Each organization has its own key, and every download from the Install page carries an enrollment key that adds PCs for 7 days. Devices installed with it belong to that organization.
An MSP's dashboard calls its organizations Clients. A company's calls them Teams, such as Finance or HR. Either way they work the same.
- Rotating a key issues a new one. Devices already installed keep working on the old key for 24 hours while they pick up the new one, and every older installer stops adding PCs.
- Unassigned devices land in a holding pool when they register with a deployment key, which ITAI staff issue for large rollouts. ITAI staff place them.
- Moving a device between organizations is recorded with who moved it and why. ITAI flags a device whose domain or network looks like it belongs somewhere else.
Plans, models & caps
Your account's superadmin sets these under Company settings.
| Setting | What it does |
|---|---|
| Device fee | A monthly fee per active device: $1, dropping to $0.90 over 50 devices and $0.75 over 100, with a $5 monthly minimum per account. |
| AI usage | On the Managed plan, your diagnoses' AI usage is billed on top of the device fee, at three times our cost for the model. A saved card is charged during the month as usage builds up (from $50). A new account is free for 30 days from sign-up: no device fees and no monthly minimum, and AI diagnoses use prepaid credit (from $5) or a card. After the 30 days a card is needed for new AI diagnoses and device fees start; any prepaid balance left is used first. With still no card 30 days after the trial ends, ITAI pauses everything but Billing until one is added. Bring your own AI key is coming soon. |
| AI model | Each organization's diagnoses run on one of the models ITAI approves for diagnosis, and usage is billed at that model's rate. Every organization diagnoses on the one that gave the most useful diagnoses in ITAI's own testing, unless someone has chosen another approved model. A superadmin can change it in Company settings, under Billing and usage. Support can also change it, and the setting always shows the model in use. |
| Monthly spend limit | The monthly AI usage at which ITAI pauses for an organization. Every organization starts at $100; your account's superadmin can change or remove it in Company settings. A diagnosis already running when it is reached may finish its current work (up to 8 more AI calls each, billed as usual). Then no new diagnosis starts and no new fix is approved or sent to a PC until the limit is raised or the month turns. A fix already on a PC finishes, restart included. Device fees aren't affected. |
| Per-ticket cap | An optional limit, in AI tokens, on how much one ticket may use. When a ticket goes past it, the diagnosis stops cleanly and tells you why. |
| Currency | All prices and charges are in US dollars. ITAI is available to companies in the United States only, for now. |
Security model
ITAI's safety doesn't depend on the AI making good choices. Five layers on the device stand between the AI and PowerShell:
- Allow-list. Investigation commands must match a read-only allow-list, or they're refused before they start.
- Constrained Language mode. Investigation commands run in PowerShell's restricted language mode.
- Process containment. Every process a diagnosis starts runs in a Windows job object and ends with it, and each command has a time limit.
- Signed approvals. A change needs an approval signed by your dashboard. The device holds only the public key.
- Locked transcript. Every command and its output is recorded to the ticket, where nothing in ITAI can edit it. It is removed only when its retention period ends or your account owner asks for your data to be deleted.
Around those layers:
- Fixes on by default, and can be switched off. Fixes are on for a new organization, and each one still needs a person's signed approval. An admin, or ITAI staff with a recorded reason, can switch any organization to diagnostics only. Every change is recorded and shown in Company settings.
- A second check. A separate AI call, with none of the diagnosis in its context, compares each proposed step with its description. Mismatches are flagged, and a step it couldn't check needs an explicit acknowledgement to approve.
- Devices never contact the AI. The dashboard makes every AI call. Each device authenticates with its own credential.
- Retention. Tickets and transcripts are deleted 90 days after their last activity, unless a legal hold requires keeping them. A slim audit record of who did what and when, with the commands run, is kept for 7 years. Admins can export your data at any time, and the account owner can ask for it to be deleted.
ITAI does not train AI models on your data. It's kept separate from other customers, with every request checked against your organization. The Security page has the full detail, including what isn't done yet.
Uninstalling
From the device page, choose Uninstall. For safety you type the device's hostname to confirm, and only admins can do it. ITAI on the PC stops and removes its service and install folder, the device is retired, and the uninstall is recorded with who confirmed it and when.
Installing ITAI on the same PC again
After an uninstall from the dashboard, run the Install page's command on that PC at any time. The device comes back to your list by itself.
If ITAI was removed on the PC itself instead, for example its folder deleted by hand, the dashboard doesn't know it is gone and still holds that PC's credential. A new install under the same organization is then refused, so that no other machine can take the PC's place. Open the device's page, click Reset credential, then run the install command again.
FAQ
Can ITAI change something without asking?
No. Investigation is limited to read-only commands on the device itself. Changes run only from a fix a person approved, and the device checks the approval's signature first. An admin, or ITAI staff with a recorded reason, can turn fixes off entirely for any organization.
What happens if the AI suggests something harmful?
During investigation it can't run it: the command isn't on the allow-list. In a plan, you'll see the exact command, its risk rating and its rollback before deciding.
Does ITAI need inbound network access?
No. ITAI on the PC only makes outbound HTTPS connections to your dashboard.
Which AI models can we use?
Each organization's diagnoses run on one of the models ITAI approves for diagnosis, billed at that model's rate. A new organization starts on the one that gave the most useful diagnoses in ITAI's own testing. A superadmin can move an organization to another approved model in Company settings, and so can support. Support for bringing your own AI provider account is coming.