AI clients and agents

AI client tools

Every tool an AI client gets when it connects to Ahamo, what it does, and which ones need a connection that may make changes.

On this page

These are the tools an AI client sees after it connects to Ahamo. Tools under Working on apps (changes) appear only on a connection allowed to make changes in development; every other tool reads.

Reading is free. Tools that start Ahamo's AI spend the workspace's credits exactly like the chat; they are marked credits below. No tool writes production data, because production changes only through publish.

Availability. As for AI clients, your organisation decides whether clients may connect, read only, or make changes in development.

Account and workspaces

ToolWhat it does
meWho the connection acts as, its options and your workspaces
list_workspacesYour workspaces
get_workspaceA workspace's name, and its plan and credits if you may see billing
security_centerYour organisation's Security center, with every workspace's apps with their open issues and last scans, or every open issue filtered by workspace, severity, category or OWASP category. Needs permission to read the organisation's audit log; not on a connection limited to one app

Reading apps

ToolWhat it does
list_appsThe apps in a workspace
get_appAn app's state, addresses and a screenshot
list_templatesThe workspace's app templates
list_files, read_fileThe app's source files (up to 2 MB a file)
get_diffSaved versions and what changed
list_tables, describe_tableThe data structure, never rows
list_migrationsData structure changes in development and production, and what the next publish applies
data_rulesWho may read and change which data
queryOne SQL statement, with development reads and writes, production reads only (see below)
list_extensionsThe database's Postgres extensions
logsThe app's recent logs
advisorsFindings of the security and code checks
list_functions, get_functionThe app's server code
filesThe app's Files library
list_settingsSecret names (never values) and variable values
list_integrationsConnected accounts linked to the app
list_chatsYour chats with Ahamo's AI in a workspace (yours, shared or all), with title, private or shared, what each is about and when it was last active
list_turns, get_turnA chat's turns and plans (chat_id, or an app's own chat by app_id), optionally waiting for one to finish
list_skills, get_knowledgeThe workspace's skills and what Ahamo's AI knows about the app
app_analyticsVisits and requests over the last hour, day or week, as counts

logs, files, query and list_extensions follow the app's AI access setting for each environment. Writes through query need a connection that may make changes.

Working on apps (changes)

ToolWhat it does
create_appCredits. Starts a new app from a prompt, a template or a GitHub repository (repository_url). With a prompt, Ahamo's AI plans it first. A public repository comes in at once; for a private one the result links to the app, where you click Connect GitHub. Ahamo's AI then reads the repository and asks its questions in the chat one at a time, and the client follows them with list_turns and get_turn and answers each with send_message. A Supabase project found in the repository shows a Connect card in the chat, which you click in Ahamo. Not on a connection limited to one app
send_messageCredits. Sends a message to Ahamo's AI in chat, plan or build mode, in a chat (chat_id), in an app's own chat (app_id), or with neither in a new private chat it starts in the workspace. Never approves a plan
approve_planCredits. Builds a plan the chat proposed, as the plan card's Build this plan does, in the chat that proposed it
edit_file, write_file, write_functionCredits. Propose code changes, as pending changes in the chat
propose_migration, propose_data_ruleCredits. Propose a data structure or access rule change, applied to development first
publishPublishes the last saved version, with the same checks and approvals as in Ahamo. When the workspace requires approval it answers that approval was requested, and a person approves in Ahamo
exportStarts Download App; you download it in Ahamo when it is ready
set_variableSets a development variable; secret-looking values are refused
request_secretReturns where you enter a secret yourself; the value never passes through the client
upload_fileAdds a file to the app's Files library (up to 10 MB through the client)
link_integrationReturns where you link a connected account
set_skill, set_knowledgePropose a workspace skill or something Ahamo's AI should know about the app; it applies once someone confirms it in Ahamo

Documentation

ToolWhat it does
search_docsSearches this documentation and returns up to 10 pages with a short passage each
read_docReads one page of this documentation

Plans and limits

LimitValue
Calls120 a minute per person
read_file2 MB
queryOne statement, 10 seconds, 500 rows
upload_file10 MB, two at a time
get_turn waitUp to 50 seconds

For agents that run on their own, see service credentials.

Troubleshooting

A changes tool is missing. The connection reads only. Reconnect with ?read_only=false and allow changes, or ask your administrator whether your organisation allows changes.

A tool says production is read-only. Production changes only through publish.

On this page