Skip to the page
Conch
DocsGitHub

What it does

Big jobs in one go

For work that takes hundreds of steps, your assistant writes one short script that uses its tools, and the chat shows it as one line.

Some jobs are the same small step, again and again: tag the invoices among 300 emails, read 40 pages and compare their prices, rename every photo by the date it was taken. Your assistant can do a job like that as one short program, a script, that uses its tools for each step. It's quicker and costs less, because your assistant reads only what the script found, not every email on the way.

You don't need to ask for a script. Your assistant writes one when a job has many similar steps, and uses its tools one at a time for everything else. Every provider can do it.

Watch it work

A script shows in the chat as one line, however many steps it takes:

  • What it's for, in your assistant's words, and how far it is, like "120 of 300 emails".
  • A thin bar that fills as it goes.
  • A count for each kind of step, like Read an email ×120 and Labelled an email ×12.
  • Stop, which ends the script at once. What it already did stays done.

When it's finished, the line says what it came to, like "Tagged 47 invoices among 300 emails", how many steps it took and how long.

Press the line to open it. You see the script itself, ready to copy, then every step it took, grouped by kind. Press a kind to see its steps, and a step to see exactly what went in and what came back. Below are the questions it asked you, and what it gave back to your assistant.

It asks, the same as always

A script can do only what your assistant could do one step at a time, and it asks about the same things. Each step is checked on its own, as it happens, in the mode you chose:

  • When a step needs your OK, the script waits. The question sits right under its line, and says which step it is: "Step 48 of the script". Your answer counts for that step, like any other.
  • If you say no, that step doesn't happen. The script carries on without it, or stops there and your assistant tells you.
  • Once the chat has read something from outside, like an email, steps that could send it somewhere still ask, as they would one at a time.
  • Many of the same thing in a row, like 50 deletes, asks first even in Full trust, script or not.

The time a question waits for you doesn't count against the script.

Put it all back

Changes a script makes to your files can be undone, all at once. Press Undo all 12 changes on the script's line (Undo its change when there's one), check what will change, and press Undo. You can press Put all 12 back again if you change your mind. Each change is also on the Activity page, with its own Undo.

Sent emails and messages can't be unsent, which is why sending always asks first.

What a script can't do

A script runs sealed off from the rest of your computer. It can't reach the internet, your files or anything else by itself. It does everything through the same tools your assistant has, and nothing more. A few things it leaves to your assistant, outside the script: asking you a question with choices, offering to turn something on, suggesting replies, updating the plan and handing work to a task.

It also has limits, so a mistake can't run away with your computer:

  • 2 minutes of work, unless your assistant gives it more (at most 10)
  • 500 steps, unless your assistant gives it more (at most 2,000)
  • 8 steps at the same time
  • 256 MB of memory
  • a few pages of results back to your assistant

If a script reaches one of these, it stops and your assistant is told which, so it can try a smaller piece.

How it did it replays every step a script took, one by one.