Skip to content

Documentation

Worked examples

Two conversations as they actually run, tool calls included. The first one carries a validation error on purpose, because watching the assistant correct itself explains the design better than any paragraph.

Building a page from nothing

A token with the read and write scope, on a page that has nothing on it yet. The assistant reads first, gets one call wrong, and fixes it with what the server told it.

  1. You

    I have a small bike repair shop. Set up my page: what I do, a price for the three most common repairs, my hours, and a form to book a repair.

  2. Assistant

    Let me see what the page has now and which blocks I am allowed to use.

  3. Calllist_pages

    AnswerOne page, in draft, reachable by this token.

  4. Callget_page

    AnswerA header and one empty group.

  5. Calllist_block_kinds

    AnswerEvery block type with its variants and its layouts.

  6. Assistant

    I will add services, prices, hours and a booking reason. Starting with prices.

  7. Calladd_block

    AnswerRejected. Unknown variant price-table for a prices block. Valid variants: list, cards, compact.

  8. Assistant

    That variant does not exist. The catalogue offers list, cards and compact, and cards reads better on a phone, so I will use that one.

  9. Calladd_block

    AnswerPrices block added, with the three repairs and their price.

  10. Calladd_block

    AnswerServices, hours and the booking reason added to the same group.

  11. Callpreview_page

    AnswerA preview link for the draft.

  12. Assistant

    The draft has four blocks and a booking form. Open the link, read it in your own voice and publish it yourself when it sounds right. This token cannot publish.

The rejected call is the interesting one. The server did not say no, it said which three variants exist, so the next attempt was right without anyone asking you.

One change across several pages

The same token, three pages, one fact that changed. The assistant works page by page and stops before publishing.

  1. You

    The studio moved. Change the address on all three pages and leave them ready for me to look at.

  2. Assistant

    Let me see which pages this token reaches.

  3. Calllist_pages

    AnswerThree pages: studio, workshop and courses.

  4. Callget_page

    AnswerEach one carries a location block with the old address.

  5. Callupdate_block

    AnswerAddress replaced on the three drafts, one call for each.

  6. Callpreview_page

    AnswerThree preview links, one per page.

  7. Assistant

    Three drafts changed and three links to check. Nothing is live: this token has no publish scope, and even with it the last word would still be yours.

Three pages and seven calls, all of them on the draft. What visitors see did not move until you decided it should.