User guide

Using XataWorks.

You have it open.
This is what everything in it does.

Twelve articles, in the order the questions tend to arrive: the window, what the assistant can do on the sites you have open, what it asks you before it acts, and how to teach it the way your team works. Every screenshot and every recording here is a frame of the real application.

The XataWorks window. On the left a chat: the question “Which Larkspur tickets have been waiting more than a week, and who raised them?”, the assistant’s run of the site’s ticket-search operation, and its answer listing the tickets and who raised each one. On the right, the Larkspur helpdesk open in the browser panel with the same tickets on screen.
One window: a conversation on the left, the web application it is working on the right. The helpdesk is fictional, the answer is real — the assistant read it out of the page’s own published operations.

Start here

Getting started

What you are looking at, and the one thing to decide before it will answer.

The part that is unlike other assistants

The web, and what it offers

The assistant works the sites you have open, in your own session. This is what that means in practice.

  • The browser panel

    Tabs and which chat they belong to, bookmarks, finding in a page, and the two permissions a site can be granted.

  • Page tools

    The actions a website offers your agent directly — how to see them, and how to ask for one.

  • Approvals and permissions

    What you are asked before an operation runs, what each answer commits you to, and how to check afterwards.

Configuration

Making it yours

The three things you add: a shaped assistant, your own procedures, and abilities it did not ship with.

  • Agents

    What an agent is made of, how to make one, and what its Tools and Skills tabs decide.

  • Skills

    Instructions, not capability. Writing one, scoping it to a site, and which one wins when two share a name.

  • Connections

    A tool server you add yourself — how it differs from a page tool, and what a failure reason means.

After the first week

Living with it

Several conversations at once, work that continues while you are elsewhere, and where all of it is kept.

  • Chats and context

    What a chat group shares, finding a conversation again, and what the model is actually told before you type.

  • Work that continues

    Tasks, scheduled prompts, and what happens to an approval question when nobody is there to answer it.

  • Your data

    Where XataWorks keeps its state, what leaves your machine, and the one thing this build verifiably never does.

These twelve are what this guide carries. Each one is written to be read on its own.