Connecting from an AI agent
An AI client or agent gets into your team's Cactus account only when you approve it: on the approval page you read what it may do, then select Allow or Deny. An agent with no browser is approved with a six-digit code on the page its link opens.
On this page
Approve an AI client in your browser
Your AI client sends you to the approval page, which asks Your agent wants to use Cactus as you. Shall I let it in? When the request asks to set Cactus up, the question reads Your agent wants to set up Cactus for you. Shall I let it in?
Read the line that says what it will be able to do, in the list under What the agent may do.
Read the line that says where it is from. It shows the host it came from, or It’s on this computer for a client on your machine, and the name the client gives itself. Cactus does not check that name.
Select Allow to let it in, or Deny to refuse it. Deny sends the refusal back to the client.
If your login runs out while the page is open, the page says Your login timed out while this page was open. Select Log in again to sign in and return.
Which team the agent works in
Allow connects the agent to the team the page names in its line about the team. The line changes with your account, and Allow does this for each case:
The page says | What Allow does |
|---|---|
It will work in {team name}, with your access. | What Allow does Connects the agent to your team, and it works with the access you have there. |
When you allow, I’ll make {team name}, with Pro free until {day}. No card. | What Allow does Creates a team that you own, on the Pro plan for the free trial, which lasts 14 days. No card is asked for. |
Your team, {team name}, is already on Cactus, with Join {team name} | What Allow does Sends you to join that team first, then returns you to the same request. |
Cactus has a waitlist for now. Click Allow to join it. | What Allow does Puts you on the waitlist. The client is connected all the same and starts working the day you are let in. |
It acts on a Cactus teamspace, and you’re not on one yet. | What Allow does Refuses the login if you came through a help site. |
On the waitlist, the page also shows a field for Or enter referral code. A code that works lets you in at once, and a code that does not work stops Allow with That code doesn’t work. Check it and try again.
The page names a help site's own address when the sign-in came through one, as It is logging in through followed by that address.
What the agent may do
The approval page lists what the client asked for, in these words.
The page says | What it lets the agent do |
|---|---|
set up your product, help site, and Messenger | What it lets the agent do Create products, connect GitHub and choose which repositories Cactus reads. |
read your pages | What it lets the agent do Read your team’s help pages, what Cactus has learned about your product from its code, and past conversations with your customers. |
ask me questions | What it lets the agent do Ask Cactus questions and start investigations. Each one starts a new conversation. |
A client that signs in for one product's address, or through a help site, is given only reading and asking. Setting up is given only on the team address. A client that names no permissions is given all three.
Connect an agent with no browser
An agent with no browser, such as a command-line tool or a server job, shows you a six-digit code and a link. The code lasts 10 minutes, and the request to connect ends after 24 hours.
Open the link the agent gave you. It opens Give this agent your team? You must be logged in to see it.
Check the page. It says which host the agent signed in through, when it asked, and the team it will act on. Under What it will be able to do it lists the same permissions as the approval page.
Type the six digits into The code the agent showed you, then select Give it my team.
When it works, the page says The agent has your team, and the agent connects in a moment.
The code only works for the email address the agent named when it registered. An agent that registers with a named address is claimed only by that person.
If you are on a team already, the claim asks you to open Cactus and join it first, then type the code again. On the waitlist, the claim still goes through and the page shows a referral field.
An agent may ask for a new code up to 10 times. A code takes 5 wrong tries before the link closes.
Remove an agent's access
Connected AI clients are listed and removed on AI clients. The approval page says the same: you can take a client back any time under AI clients.
Only the person who claimed an agent can end its connection.
If a connection fails
What you see | What it means | What to do |
|---|---|---|
This approval link is incomplete. Start again from your agent. | What it means The page opened without the whole request. | What to do Start the connection again from your AI client. |
Couldn’t verify this approval link. Start again from your agent. | What it means The link could not be checked. | What to do Start the connection again from your AI client. |
This login has expired. Start it again from your AI client. | What it means The sign-in request is older than 10 minutes. | What to do Start the connection again from your AI client. |
Join a teamspace before connecting an AI client. | What it means You logged in through a help site and are on no team. | What to do Join a team first, as Joining a team explains, then connect again. |
That code doesn’t work. Check it and try again. | What it means The referral code is not one Cactus accepts. | What to do Check the code, or leave Or enter referral code empty to join the waitlist. |
This agent asked for somebody else | What it means You are signed in with an email other than the one the agent named. | What to do Log in as the person the agent named, then open the link again. |
That isn’t the code | What it means The six digits do not match the code the agent showed. | What to do Type the six digits again. |
Too many wrong codes | What it means Too many wrong codes closed the link. | What to do Ask the agent to start again. |
This code has expired | What it means The 10-minute code has run out. | What to do Ask the agent to start again. |
This agent already has a team | What it means Someone already typed its code. | What to do If that wasn’t you, tell your team. |
This claim link can’t be verified | What it means The link is not one Cactus knows, or it no longer works. | What to do Ask the agent to start again. |
Join your teamspace first | What it means Your team is already on Cactus, and you have not joined it. | What to do Open Cactus to join your team, then type the code again. |