Arbituro docs

Knowledge

Each project keeps a library of documents for its agents to read and cite, such as policies, price lists and past reports. A document reaches agents only when an owner or project admin publishes it.

What it is for

Open Vault, in the tabs at the top of a project, to see its documents. Agents working in the project search them and read them, and the results they deliver cite the documents they relied on. Your team can find them too, under Search.

Add a document

Choose New document, then write one or upload a file:

  • Text: .txt, .md, .csv, .json and .log
  • Documents: .pdf, .docx and .xlsx
  • Up to 25 MB each
  • Arbituro reads the text of each file. It doesn’t read images, so pictures can’t be uploaded.
  • Headings in a Word document become sections. Each sheet of an Excel workbook becomes a section with its table, and dates read as dates.
  • Password-protected PDFs can’t be read.
  • Up to 200,000 characters of a document’s text are read. The file itself is always kept whole.
  • A project holds up to 500 documents, each with up to 50 revisions.

Publish to agents

Each upload is a revision, and revisions never change once made. Edits you type save to a working copy, which you can publish as a new revision or discard. Agents read only the revision that is published.

  1. Choose Publish on the revision.
  2. Read through the text Arbituro got from the file, to the end. That text is what agents will read, so check it matches the document.
  3. If Arbituro finds anything that looks like a credential, such as an access key, a token, a private key or a signed web token, it shows each one, and you have to confirm you have read each one and that it is safe before it publishes.

Arbituro won’t publish a revision whose text isn’t ready, has changed since you read it, or exactly repeats another published document. A newer revision that isn’t published yet is marked as staged, and agents keep reading the published one.

Who sees what

Every project member
Reads every document and its revisions.
Owners, project admins and editors
Add documents, upload new revisions, and edit a document’s working copy.
Owners and project admins
Publish, retire, mark reviewed, and change a document’s owner.
Agents
Read and cite published documents in their own project. They can’t add or change documents.

Workspace viewers can read documents but not change them, whatever their project role.

Citations

When an agent relies on a published document, its answer cites it with a numbered note, naming the revision and section it read. The foot of the answer lists what it stood on and what else it read. If the document has moved on to a newer revision since, the citation says so.

Keep it current

  • Mark reviewed sets the next date the document should be reviewed, 90 days ahead by default. When that day comes, the document’s owner is reminded in Your turn.
  • Retire takes a document out of what agents read. Publishing it again brings it back.
  • Mark as replaced records that another document has taken its place.

Something missing or wrong? Email support@arbituro.com.