How to talk to the agent

Plain language works. The agent is not a search box and it does not need magic words. It needs the same things a colleague would need.

Say what you see and what you want

Give it three things:

Tell itExample
Where"the footer on the contact page", "the chat module", "the admin page for news"
What is wrong"the heading is cut off on mobile", "the button does nothing"
What you expect"it should wrap to two lines", "it should open the form"

Good:

On the news page, the date under each article is in English. It should be Danish, like the rest of the page.

Weak:

Fix the dates.

If your message is too thin, the agent asks instead of guessing. That is on purpose.

Screenshots and links help

Paste a screenshot straight into the chat. Paste the preview link of the page you are looking at. Both save a round of questions.

Tickets

Paste the ticket number and the agent reads the whole ticket first — description, comments, screenshots:

Look at PM-1234 and tell me what you think the problem is.

Fix PM-1234.

Post a summary of what you found on PM-1234.

The first time, the agent asks you for a Tickets API key. Open Tickets → Settings → API keys, create a key named worker, and paste the gp_… value into the chat. From then on it acts in Tickets as you.

Brain

The agent knows the code, but Brain knows how GoPublic wants things to work: how a module should look, our editorial conventions, past decisions. It searches Brain on its own when a question is about "how we usually do this". You can also nudge it:

Check Brain for how the chat module headline is supposed to look before you change it.

Phrases with a specific meaning

Some words trigger things. Use them when you mean them.

You sayWhat happens
push the changes / commit and open a PR / publish / ship itThe agent puts the work on GitHub on a branch and, if asked, opens a pull request. See Branches and publishing.
merge itMerges a pull request. Only after review. Publishing never merges by itself.
reset to default / reset the previewWipes your preview back to the blank template. Unpublished content is gone.
restore Trafikstyrelsen from silver (a client and an environment)Copies a real client's content into your preview. Heavy and slow. See Preview, restore, and reset.
discard the local code changesThrows away unpublished code on the worker. Reset does not do this.
show me the agent wikiRecreates this wiki as pages on your preview and gives you the links.
run the tests / verify thisRuns the automatic test suite against your preview. The agent offers this after bigger changes; it does not run it after every small tweak.

Phrases that do NOT publish

"Done", "looks good", "thanks", "perfect", "ok". The agent reads these as you are happy with the preview, not as put it on GitHub. If you want it on GitHub, say so.

The agent may tell you it is not a bug

About one in four support reports is the product working as designed (the classic: upload a .webp, then complain that "download original" gives you a .webp). The agent reproduces every bug before it touches code. If it cannot reproduce it, it asks you for more. If it reproduces the behaviour and the behaviour is correct, it says so and explains why. That is a valid answer, not the agent being lazy. If you still want the behaviour changed, say "treat this as a change request".

Keep one job per chat

A new chat for a new job keeps things clean. Inside one chat, the agent remembers everything you said.

When it goes wrong

  • It did something you did not ask for — say so. "Undo that" works for code changes. For content, see Preview, restore, and reset.
  • It is going in circles — stop it, describe what you see right now, and what the goal is. Restating the goal beats piling on corrections.
  • It says it cannot — ask why. Often it is a permission it does not have (live sites, production data) and a human needs to step in.