Make a card by describing it
Say what you want in the chat: “make me a card showing my Proxmox VMs over 80% memory”, or “a card of containers that restarted today”. The assistant builds it with no code, shows you the real card, and saves it once you approve.
It needs assistant.access.config set to control, and an owner’s account. In ⌘K, New card… opens the chat with “Make a card that shows ” in the box, ready for you to finish. It’s only there when the assistant could save the card.
assistant: access: { default: read, config: control }What it does
Section titled “What it does”The card it writes is a type: api block, the same one you’d write by hand, so it runs with no model afterwards.
- It looks for the data Valet already has.
config_readlists every widget, andwidget_sampleshows the start of one’s card. If a widget has what you asked about, the new card usesfrom:that widget: no new request, no keys. - Otherwise it reads the service. For a service already in your config, it reuses that block’s address and
${NAME}s, which can only go to the host they already go to.api_samplefetches the address once, after you approve, and shows it what came back. - It writes the block. Paths into the data, an expression for anything worked out (
=mem / maxmem|pct),whereto keep the rows you asked about andsortto put them in order. - It checks it.
config_previewshows the diff and any problems without contacting anything.config_trymakes the card once, after you approve, so you see it with real data. - It saves it, and puts it on the page.
config_applyasks you first, and adds the card tolayout. It’s told to ask where when that isn’t clear.
config_undo takes the last save back.
What stays the same
Section titled “What stays the same”Building a card changes none of the rules on what the assistant can and can’t do.
- A secret only goes where it already goes. A new card can’t send a
${NAME}to a new host, and it can’t write a secret into the file. - Nothing is saved without your yes, and nothing with a problem is saved at all.
widget_samplereads only widgets the assistant may read. Withproxmox: noneinassistant.access, it can’t see the Proxmox card, can’t try a card made from it, and couldn’t read such a card back if you made one by hand.- A card made with
from:is seen only by someone who may see its source. For someone with a profile, that means the source is on one of their tabs too.
People with a profile can’t build cards: the config is the owners’.
- Name what you’d see: “VMs over 80% memory, biggest first” is easier than “a memory card”.
- Ask for a change after it shows you the card: “only the stopped ones”, “sort by name”, “as a table”.
- The block is yours afterwards. Open the config to tweak it, or ask the assistant again.