Agiled AI

Write good worker instructions

Give a worker clear instructions so its results need fewer changes.

Clear instructions are the difference between a result you can use straight away and one you have to rewrite. Write them like a brief for a new assistant.

Write the instructions

  1. Open the worker and select Edit.
  2. Under Shape how your worker works, say what the worker does in one sentence, such as "Write weekly client updates for my projects".
  3. Say what to work from, such as the project's tasks from the last 7 days or the attached brief.
  4. Describe the result: headings, length and tone, such as "three headings, under 200 words, friendly".
  5. Say what it must not do, such as "Don't promise dates or discounts".
  6. Say when to stop and flag it for you, such as "If the client is unclear, say so instead of guessing".
  7. Select Save changes.

You're done when the next result needs few or no changes.

Example

Write a weekly status update for the project I name. Use its tasks from the last 7 days. Use the headings Done this week, Coming next and What we need from you. Keep it under 200 words and friendly. Don't mention prices. List anything you couldn't confirm at the end, for me only.

More ready-to-paste examples are in AI worker examples.

Fix a result that's off

The result is…Add to the instructions
Too vagueThe exact details you want, such as dates, amounts or names.
Too long or in the wrong toneA word limit and a short example of how it should sound.
Using the wrong informationWhere to look, such as "only this project's tasks". In Tools & access, turn off areas it doesn't need.
Too sure of itself"List anything you couldn't confirm separately."

Good to know

  • Keep the instructions about the job in general. Put this week's details, such as the client and dates, in each job you give it.
  • One worker, one job. Make a second worker rather than adding a different job to the same one.
  • Instructions don't replace Workspace changes. To make sure a worker never changes anything, choose Read and prepare files only.

On this page