Get started

Write requests the agent understands

Get better results from the eComGear agent: how to word a request, what to attach, when to plan first, and how to keep each change small and safe.

The agent does what you ask, so a clear request gets a clear result. This page gives the habits that work best, with examples. You can write in English or Traditional Chinese, and you can switch language mid-conversation.

The short version

  1. Say what you want, where it goes, and who it is for.
  2. Ask for one thing at a time.
  3. Give real facts: names, numbers, prices, hours.
  4. Check the preview, then ask for the next change.
  5. Undo anything you do not like.

Say what, where and who

Weak Better
Make it nicer Make the homepage heading larger, use a calm blue and green colour scheme, and add more space between sections.
Add a form Add an enquiry form to the Contact page with name, phone and message, and show a thank-you message after sending.
Fix it On the phone view the menu overlaps the logo. Fix the header so both fit.
Translate Translate every page to Traditional Chinese with Hong Kong wording, and add a language switcher in the header.

Name the page or section you mean. Say what you see and what you expected. If you are not sure of the word for something, describe it: the big picture at the top of the first page.

One change at a time

A request with ten changes is hard to check and hard to undo. Send the most important change, look at the result, then send the next. If you already know all the changes, add them to a queue instead of waiting. While the agent is working, the box says Add a task for after this one… and the button is Add to queue. See Queue several changes.

Give real facts

The agent does not invent your phone number, address, prices or reviews. It uses a marked placeholder when it does not know. Tell it the facts and it replaces them:

  • Our WhatsApp number is +852 9123 4567.
  • We open Monday to Saturday, 9 am to 6 pm, closed on Sundays.
  • The haircut is 280 and the colour starts at 600.

For facts that should apply to every later request, save them in your project settings under Knowledge. See Teach the agent about your business.

Attach what you can show

A photo or a document says more than a paragraph. Press Attach file in the chat, drag files in, or paste an image.

Limit Value
Files per message Up to 10
Each file Up to 10 MB
Types JPEG, PNG, WebP, GIF, SVG, PDF, text, CSV, Markdown, JSON, Word, Excel

Good uses: a logo, product photos, a price list as a spreadsheet, a menu as a PDF, or a screenshot of a page you like. Say what to do with it: Use this photo as the first product, and this logo in the header. See Attach files and images.

Plan first when the idea is big

In Plan mode the agent discusses and writes a plan, and changes nothing on your site. The chat says: Plan mode is on: I will write a plan and change nothing on your site. When the plan looks right, press Build this now, or switch to Build. Toggle between the modes with Alt + P.

Use Plan for a new feature, a redesign or anything you are unsure about. Use Build for clear, small edits. See Plan mode and Build mode.

Point at the thing

For a change to one heading, button or picture, use Inspect. Click the element in the preview, then type what should change. The box says What should change here? Hold Ctrl (Cmd on a Mac) to pick several elements, press Esc to clear, and Alt + Up to pick the parent. See Change one element at a time.

Keep messages short enough

A message can be up to 4,000 characters. Past that you see how many characters you are over. Press Enter to send and Shift + Enter for a new line. Press Stop to stop a run.

Answer the agent's questions

Sometimes the agent asks a few short questions before it builds. Answer, or press Let the agent decide. Answers you skip are decided by the agent, and it tells you what it chose.

Good first requests by business type

Business A starting point
Restaurant A website for a noodle shop in Sham Shui Po with a menu, opening hours, a map and a WhatsApp button. English and Traditional Chinese.
Salon A booking site for a hair salon where clients pick a service and a stylist and send a booking request.
Shop An online store for handmade candles with product pages, a cart and checkout.
Portfolio A portfolio site for a photographer with a project gallery, an about page and a contact form.
Internal tool A tool for tracking equipment loans: who has what, when it is due back, and which loans are overdue.

When the result is wrong

  • Press Undo this change, then try a clearer request.
  • Press Ask it to fix on the reply if the agent says the app has errors.
  • If the agent stops early, press Keep going or Finish the rest.
  • If a page does not load, see Fix a page that does not load.
  • Rate a reply with Helpful or Not helpful so we can improve.

繁體中文