Documents

The document list inside a knowledge base: find documents, follow their processing, open them in Chat, and correct what Orbit identified.

Opening the list

Click a knowledge base in the list on the left of the Knowledge Base page. You also land here from the overview's Needs attention and Recently added cards, and from a search result.

A Personal knowledge base open: Upload documents and Favorites cards; a toolbar with Search documents, Status: All, Tag: All, Retag all and two icons; a table with Name, Entity, Published and Tags columns where each row shows a PDF icon, the file name, pages and size, a Pub. or Priv. entity, a date and blue and grey tag chips with + Add tag; a pager reading Total 23. On the right: the knowledge base's name with a pencil, Personal, its description, Custom tags, Members, Owner, Documents and Updated.
With the details column open, the table only has room for its first four columns. Status, Uploaded by and Action are further right — scroll the table sideways, or hide the details column with the button at the top right of the page.

Above the table sit the Upload documents and Favorites cards, and — while a batch is on its way — the upload status row described in Uploading documents.

The details column

ItemShows
Name and pencilThe knowledge base's name. The pencil edits the name and description, if you can manage it — see Managing knowledge bases.
Scope lineOrganization, Personal or Shared.
DescriptionWhat the knowledge base is for.
Custom tagsThis knowledge base's own tags. See Tags.
MembersWho has access — Only me, Members only or Visible to everyone — with their avatars. Opens the sharing dialog where there is one; see Sharing and members.
OwnerWho created it.
DocumentsHow many it holds, with a bar and a count for each status.
UpdatedWhen it last changed, and when it was created.

What you can do here

Anyone who can see the knowledge base can open its documents, chat with them and mark them as favorites. Uploading, renaming, deleting, retagging and correcting a document's entity, date or tags need edit rights — see Managing knowledge bases. Without them, the edit controls described below simply are not there, and a document's menu says You can only view this knowledge base.

The table

ColumnShows
NameThe file's type, its name, and underneath, its page count and size. A star marks your favorites. Hold the pointer over a long name to read it in full.
EntityThe company that published the document. See Entity.
PublishedWhen the document was published. See Published date.
TagsThe tags Orbit applied. Hold the pointer over the ⓘ in the heading for a reminder of how tags work. See Tags on a document.
StatusWhere the document is in processing. See Statuses.
Uploaded byWho uploaded it — Me for you, a dash if that account no longer exists.
ModifiedHidden until you turn it on. The date the document last changed.
CreatedHidden until you turn it on. The date it was uploaded.
ActionChat, Preview PDF and More. See Opening a document and The document menu.
  • Click the Name, Published, Status, Modified or Created heading to sort. Unsorted, the newest uploads come first.
  • Drag the edge of a heading to widen or narrow a column.
  • The pager under the table shows the total and pages through it, 50 documents at a time by default; switch to 20 or 100 per page there.

Choosing columns

The Columns icon at the top right of the table opens a list of the columns with a tick beside each. Name is always shown. Reset to default brings back the original set. Your choice is remembered on this browser and applies to every knowledge base.

The Columns panel open under the table toolbar, listing Name (ticked and greyed out), Entity, Published, Tags, Status and Uploaded by (ticked), Modified and Created (unticked), and Reset to default at the bottom.
The default set. Reset to default is greyed out until you change something. Unticking a few columns is the other way to bring Status and Action into view without scrolling.

Statuses

The Status column follows each document from upload to ready.

StatusMeaningWhat you can do
ParsingUploaded, and waiting for or going through text extraction.Preview, rename or favorite it. Chat, retag, corrections and delete wait until processing finishes.
TaggingOrbit is identifying the company, the date and the tags. Also shown while a document is being retagged.As for Parsing. A document being retagged can still be opened in Chat.
ReadyDone.Everything.
IncompleteProcessing finished, but Orbit could not identify the company — often because the first pages hold no readable text, as in a scan.Correct, retag, rename, delete. Not chat. Setting the entity by hand does not change the status — it stays Incomplete and still cannot be chatted with; retagging may get it to Ready.
FailedProcessing failed.Delete it and upload it again.

The list does not update by itself. Click the Refresh icon at the top right of the table to see progress.

Finding documents

ControlNotes
Search documentsFinds documents whose name contains what you typed, ignoring upper and lower case. Press Enter to search; clearing the box shows everything again.
Status: AllPick one or more statuses.
Tag: AllPick one tag, from Global tags or this knowledge base's Private tags.

When the table is empty, it says why.

SituationThe table says
Filtered outNo documents match the current filters. Your search or filters exclude everything; Clear filters resets them.
EmptyNo documents in this knowledge base yet. Upload documents is offered if you can upload.
No favoritesNo favorites yet, in the favorites view.
Load errorCouldn’t load the documents. Try again reloads.

Opening a document

ClickWhat happens
The document's name A Ready document, or one being retagged, opens in PDF Chat, in the same tab, where you can ask questions about it. A Failed document has nothing to preview and only shows Nothing was stored for this document.; any other opens in the PDF preview.
Chat Opens the document in PDF Chat, as above. Greyed out until the document is ready — hold the pointer over it to see why.
Preview PDF Opens the document in a panel from the right, without leaving the page. Greyed out for a document that failed, since nothing was stored.
Asking questions is charged

Opening a document in PDF Chat is free; asking it questions is charged as described on PDF Chat.

The document menu

Click More in a document's row, or right-click anywhere on the row.

The table scrolled to its right-hand columns — Published, Tags, Status showing Ready, Uploaded by showing Me, and Action with three icons. The More icon's tooltip reads More and its menu lists Add to favorites, File info, Retag with model, Rename and, in red, Delete. The row is highlighted.
The three Action icons, left to right: Chat (the sparkle), Preview PDF (the eye) and More. The row stays highlighted while its menu is open.
ItemWhat it does
Add to favoritesMarks the document as one of your favorites. On a favorite it reads Remove from favorites. Available to everyone who can see the document.
File infoThe document's details. See below.
Retag with modelHas Orbit read this document again. See Retagging. Only for Ready and Incomplete documents.
RenameSee Renaming a document.
DeleteSee Deleting a document.

Retag with model, Rename and Delete only appear if you can edit the knowledge base. Esc or a click elsewhere closes the menu.

File info

A read-only summary: Name, Format, Size, Pages, Status, Knowledge base, Published, Uploaded and Modified.

The File info dialog listing Name with the full file name, Format PDF, Size, Pages, Status Ready, Knowledge base, Published, Uploaded and Modified dates, and a Close button.
The full file name, with nothing cut short. Nothing here can be edited; Close or the × dismisses it.

Renaming a document

Choose Rename, edit the File name and click Save. The name is required and can be up to 255 characters; two documents may share a name. Document renamed confirms it.

The Rename document dialog with a required File name box holding the current name, and Cancel and Save buttons.
The box starts with the current name, extension included, so you only need to change the part you want.
Keep the extension

The file type shown in the table and in File info is read from the end of the name. Rename report.pdf to report and the document no longer shows as a PDF.

Deleting a document

Choose Delete, read the confirmation and click Delete. Document deleted confirms it.

A confirmation whose title asks whether to delete the document, quoting its full file name, with the message This will permanently remove the document from this knowledge base, and Cancel and Delete buttons.
The title quotes the document's full name — check it before clicking Delete, which is the highlighted button.
There is no undo

The document is removed from the knowledge base for everyone, along with anyone's favorite mark on it. A document still being parsed or tagged cannot be deleted — Orbit tells you to wait. Once it is deleted you can upload the same file again.

Correcting what Orbit identified

Orbit fills in a document's entity, published date and tags on its own. If it got something wrong, correct it in the table. Corrections are possible on Ready and Incomplete documents, by anyone who can edit the knowledge base, and are blocked while a document is being retagged.

Retagging undoes your corrections

Retagging a document replaces its entity, published date and tags with whatever Orbit finds again — including anything you corrected by hand. See Retagging.

Entity

The Entity column names the company that published the document. Up to two are shown; more are gathered under +N more — hold the pointer over it to see them all.

ItemMeaning
Pub.A company Orbit covers. When Orbit has matched it to a company, click it to open its company page in a new tab.
Priv.A private entity — a company Orbit does not cover, either found while tagging or added by hand. Not clickable.
Identifying…Orbit is still working on it.

To change it, hold the pointer over the cell and click the pencil (Edit entity), or use Edit entity in the +N more list.

The Edit Entity dialog: the document's file name, a required Entity search box reading Search Orbit companies or private entities, the current entity as a Pub. chip with a ×, an explanation of Pub. and Priv., and Cancel and Save buttons.
The document's current entities sit under the search box. Inside the dialog, × only takes an entity off the list — nothing changes on the document until you click Save.
  • Search Orbit companies and your Private entities in one box. If the company is not there, choose Add “…” as a private entity; it is created when you save.
  • A document needs at least one entity, and can have up to 100 of each kind.
  • Click Save. Entities updated confirms it. The change applies to this document only.

The +N more list also has a × on each entity to remove it on the spot, without a confirmation. The last entity cannot be removed that way — add another first.

Published date

Hold the pointer over the Published cell and click the pencil (Edit published date). Pick a date and click Save; the date cannot be left empty. Published date updated confirms it.

The Edit published date dialog: the document's file name, a required Published date box holding the current date with a calendar icon and a clear button, the hint The date the document was published or released, and Cancel and Save buttons.
Click the box for a calendar. The clear button at its right end empties it, but Save then refuses with Select a date. — a published date can be changed, not removed.

Tags on a document

The Tags column shows up to six tags; more are gathered under a +N badge — hold the pointer over it to see them all, split into global and private. Global tags are blue with a globe icon; private tags are tinted in the tag's own colour, with a dot of that colour.

  • Remove a tag with the × on its chip. There is no confirmation; Tag removed confirms it. Only this document is affected. A tag Orbit applied may come back the next time the document is retagged.
  • Add a tag with + Add tag. Choose Global tag or Private tag, pick one from the list — each shows its definition — and click Add tag. Only existing tags can be added; to create a new private tag, see Custom tags. Not available in the favorites view.
The Add tag dialog: the document's file name, a Type choice of Global tag or Private tag with Private tag selected, a required Tag box reading Pick a private tag of this knowledge base, a note that private tags are created from the Custom tags panel on the right, and Cancel and Add tag buttons.
Private tag is selected to start with. The list leaves out tags the document already has.

Retagging

Retagging has Orbit read documents again and fill in their entity, published date and tags from scratch. Use it after adding or changing a custom tag — tags only apply to new uploads otherwise — or when the first attempt went wrong.

ButtonWhere, and what it retags
Retag allAbove the table. Every Ready and Incomplete document in the knowledge base; others are skipped, and the dialog says how many.
Retag selected (N)Replaces Retag all once you tick rows. The ticked documents that can be retagged — N counts only those.
Retag with modelIn a document's menu. That one document.
Two rows ticked in the table and the Retag 2 documents dialog open, explaining that the model reads the 2 selected documents and fills in the entity, published date and tags again, replacing what they have now including edits made by hand, and that it takes about 10 to 60 seconds per document in the background, with Cancel and Retag buttons.
Two documents ticked, so the toolbar button reads Retag selected (2). The dialog spells out that hand-made corrections will be replaced.

Orbit first checks the documents' latest status, then asks you to confirm. Click Retag. The documents show Tagging while it works — about 10 to 60 seconds each, in the background — and a notice above the table says so; click Refresh in it to see the results, or Dismiss to hide it. Retag all is refused while a retag is still running in the knowledge base.

Retagging needs edit rights. If none of the documents can be retagged, Orbit says so instead of asking — for example Only ready documents can be retagged. The selected documents are still processing or failed.

Tags

Every document can carry two kinds of tag.

KindSet byApplies to
Global tagsOrbit. The same for everyone, and cannot be changed. Listed on the overview.Every knowledge base.
Private tags (custom tags)Whoever manages the knowledge base.This knowledge base only.

For both, Orbit reads each uploaded document and applies every tag whose criteria the document meets.

Custom tags

Custom tags are listed in the details column of the knowledge base, each with the number of documents carrying it — click the number to filter the table to those documents. If you can manage the knowledge base, + adds a tag and clicking a tag edits it.

The Edit custom tag dialog for a tag named AI Strategy: its Tagging criteria describing AI investment, products or strategy and excluding passing mentions, six colour swatches with the first selected, an explanation of how tags are applied, and Delete, Cancel and Save buttons.
Editing an existing tag adds Delete. The criteria here say what does not count as well as what does — Not: passing mention of AI without substance — which is a good habit when writing your own.
FieldNotes
Tag nameRequired, up to 60 characters. Must differ from this knowledge base's other private tags, ignoring upper and lower case. It may repeat a global tag's name.
Tagging criteriaRequired, up to 500 characters. Describe when a document should get this tag — Orbit applies it to documents that meet the description.
ColorBlue, Green, Purple, Orange, Pink or Gray. Only changes how the tag looks.
ChangeEffect on documents
Add a tagNone yet. It is applied to new uploads; retag to apply it to documents already here.
Rename a tagRenamed on every document that has it. Not possible while a retag is running.
Change criteriaNone until you retag.
Change colourEvery chip of that tag changes colour straight away.
Delete a tagRemoved from every document in this knowledge base and no longer applied to new uploads. Global tags are not touched.

To delete a tag, open it and click Delete, then confirm. Deleting cannot be undone, and is not possible while a retag is running.