The panel and its three modes
The Cloud page can be used in three ways, AI, Normal and Nerd: same data, same operations, three levels of detail.
The Cloud page
A project's whole cloud is on a single page, Cloud. At the top right:
- the project you are working on, if you have more than one;
- View mode, with three choices: AI, Normal, Nerd. The panel remembers the last one.
Next to the title you can see the zone code (for example gk01).
Switching mode does not change anything that exists: the three views read the same data and call the same operations, which are also those of the API and the MCP.
AI mode (the default)
Write what you need, in your own words, in the Ask, or say what you want done field, and press Send. The assistant looks into the project and answers, or prepares what you asked for.
How it behaves:
- it reads on its own: lists, details, usage, open ports, attacks, pending requests;
- it changes nothing on its own. Every change stops and is shown to you in words written by the platform (not by the model), with the plan of what will change. It only goes ahead if you press Do it; with No nothing happens;
- for anything that destroys (deleting a server, a cluster, a node pool) you have to type the name again: Type … to confirm;
- your yes does not go through the model: it reaches the platform in a separate call, and exactly what was shown to you is carried out;
- it can only do what your role allows, just as if you did it yourself in the panel.
Things the assistant deliberately does not do:
- it does not give you a cluster's kubeconfig (it is a credential with full rights): you download it from Normal mode;
- it does not start an import from vCenter or ESXi, because that would mean typing a password into the chat: you do it from the Imports section;
- it does not accept passwords or other secrets: if you give it one, it refuses and sends you to the panel.
Next to the conversation, the Right now column shows what is waiting for someone: pending change requests, imports in progress, clusters, ongoing attacks.
A conversation can be resumed for two hours. Each message is at most 4000 characters long, and there is a cap on messages per hour per person. If you see The assistant is not switched on yet, the assistant is not switched on: everything it would do is available in Normal, in Nerd and in the API.
Examples of things to ask
The panel already suggests a few phrases, for example What is running, and how much room do I have left?. You can also write in Italian:
- "What have I got running, and how much of my quota is left?"
- "Create a small Ubuntu server with a public address and port 443 open."
- "Create a server
web-1with 2 vCPUs and 4 GB using my SSH keylaptop, and open port 22 only from my office 203.0.113.7." - "Which ports are open to the whole internet?"
- "Close port 8080 on
web-1." - "Stop all the test servers."
- "Give the server
mailthe reverse DNSmail.example.ch." - "Add an A record
wwwto the zoneexample.chpointing to the address ofweb-1." - "Am I under attack? Show me the attacks from the last week."
- "Create a Kubernetes cluster with three small nodes."
- "How much have I spent this month in this project?"
- "Are there any pending change requests?"
The more precise you are (names, sizes, ports, from where), the fewer questions it asks. Before you say Do it, read the box: that is where it says what will actually happen.
Normal mode
The usual screens. At the top, operations in progress and pending change requests; below, the sections:
| Section | What's there |
|---|---|
| Servers | Usage against quota (Servers, vCPU, Memory, Disk, Public IPs), the servers, the Public addresses table and the Disks table |
| Kubernetes | The clusters, if the zone offers them (Kubernetes) |
| Imports | VMs brought in from other hypervisors, if the zone offers it (Importing a VM) |
| Protection | Attacks on your addresses (Attack protection) |
| Requests | Change requests from agents (Plans and change requests) |
A section the zone does not offer does not appear.
Before every change the panel shows you the plan, Before it happens: what will be created, changed or destroyed, the quota afterwards (Quota after this change), and whether it can be undone. Then press Do it. If the platform would refuse the change, it tells you right there (The platform would refuse this. Nothing was changed.) without changing anything.
Nerd mode
The same data, without rounding:
- at the top: the project id (
tenant), the zone, the private network, your role, how often the page refreshes; the r key (or refresh) reloads immediately; - the tables with identifiers and values exactly as they arrive;
- the jobs with their codes;
- the call log (calls): every call made by the page, with the data sent (
call_data), the response or error, the time, the same request as acurlto/api/rpcand the name of the MCP tool that does the same thing. It is the quickest way to learn the API: do something in the panel and copy thecurl; - at the bottom, the JSON of
Cloud/getStatusandCloud/getCatalog.
The curl uses the $GIGAKUBE_API_KEY variable: put one of your API keys in it.
For developers
The assistant is not open to API keys: if you have a program or an agent, use the MCP with your own model. The assistant's tools are the same as the MCP's, except cloud_get_kubernetes_kubeconfig.