Glossary

This page renders GLOSSARY.md at the repository root. Edit the terms there.

Building botsCopy Anchor Link

Bot: A configured chat partner that answers with one behaviour, its repositories and its features. German: Bot Avoid: agent, assistant, chatbot

Behaviour: A reusable block holding a system prompt and answer settings that decides how a bot writes. German: Verhalten. Where German needs a plural or a count, Verhaltensvorgabe, pl. Verhaltensvorgaben Avoid: AI behaviour, behaviour block, template, template block, KI-Verhalten, Verhaltensblock, Vorlage

Repository: A reusable block holding assets that a bot or chat searches to ground and cite its answers. German: Repository, pl. Repositories Avoid: repository block, database block, knowledge base, retrieval database, content collection, Wissensdatenbank

Block: The umbrella for behaviours and repositories, used only where both kinds are meant. German: Block, pl. Blöcke Avoid: building block, any compound ("behaviour block", "repository block", "Repository-Block")

Feature: A built-in capability a bot or chat switches on: web search, questions and quizzes, generative UI. German: Funktion Avoid: built-in behaviour, tool

Questions and quizzes: The feature that lets a bot ask the user structured questions and run quizzes it grades. German: Fragen und Quiz, Quiz Avoid: Questions & quizzes, Fragen & Quiz

System prompt: The instructions inside a behaviour that the model reads before every answer. German: System-Prompt

Draft, Published: The two publication states of a bot or block. Only a published bot can be chatted with by others. The code value of Published is ready. German: Entwurf, Veröffentlicht Avoid: Ready (that is a preparation state)

Publish: Move a bot or block from Draft to Published. German: veröffentlichen Avoid: list (that is the catalogue)

Library and assetsCopy Anchor Link

Library: The area that holds everything an organisation can use: what it made and what it added from the Catalogue. Capitalised as an area name. German: Bibliothek Avoid: Content Library, library (lower case)

Asset: A file uploaded to OrcAI, with its metadata, kept in the Library and reusable in any number of repositories. Images are assets too. Inside a repository it is still an asset. German: Asset, pl. Assets Avoid: document, material, source material, content, content item, item, Dokument

File: The uploaded original of an asset, as it was on the uploader's disk. Used for upload, download, file type and size, never for the asset itself. German: Datei

Chat upload: An asset uploaded with a chat message. The Library's default views leave it out, and the Assets view lists it under Kept in > Chats until someone adds it to the Library. Only then can it go into a repository. German: Chat-Upload

Metadata: The descriptive fields of an asset (title, description, language, source type, citation label and the type's own fields). The editor for them is opened with Edit metadata. German: Metadaten Avoid: source details, content (for the fields), Quellenangaben (for the form)

Citation label: The full reference to an asset's source in APA 7 style, part of its metadata and shown with a citation. German: Kurzbeleg Avoid: Zitat, Zitatbezeichnung

Preparation: Everything between upload and searchable: reading the file, describing images, indexing it in each repository. Running it once more is Prepare again. German: Vorbereitung, vorbereiten, Erneut vorbereiten Avoid: processing (as the umbrella), reprocess, ingestion, Verarbeitung (as the umbrella), Auftrag

Queued, Processing, Indexing, Ready, Failed: The preparation states of an asset. Indexing exists only inside a repository. German: In Warteschlange, Wird verarbeitet, Wird indiziert, Bereit, Fehlgeschlagen

Retrieval: Finding the passages in a repository that match a question. A repository's retrieval mode sets how. German: Abruf

Passage: A piece of an asset after it is split for search. A bot retrieves passages and cites them. A repository sets how many it returns with Passages per answer. German: Passage, pl. Passagen Avoid: chunk, reference, references (for the count per answer), Verweis

Citation: A marker in an answer that points to a source of the chat: a retrieved passage and its asset, a web page, a docs page or an attachment. German: Quellenangabe Avoid: reference, Zitat, Verweis

Source: What a bot answers from, and a cited asset or web page under an answer. Sources a bot is limited to are approved sources. German: Quelle, geprüfte Quellen Avoid: source for where a Library item comes from (that is origin), freigegebene Quellen

Origin: Where something comes from. For a Library item, whether it was made in this organisation or added from the Catalogue. In the access overview, how someone has access: as a user, through a group or all members, inherited from a bot, block or the organisation, or because it is public. German: Herkunft Avoid: source

Explore: Read a repository's passages or search them the way a bot does. German: Durchsuchen

CatalogueCopy Anchor Link

Catalogue: The instance-wide list of bots and blocks that organisations have listed for others. Capitalised as an area name. German: Katalog Avoid: catalogue (lower case), marketplace, gallery

List, Listed, Not listed: Put a bot or block in the Catalogue, and the resulting state. German: in den Katalog aufnehmen, Im Katalog, Nicht im Katalog Avoid: publish, share, public, private

Add from the Catalogue: Make a listed bot or block usable in your organisation. Remove undoes it. German: aus dem Katalog hinzufügen, entfernen Avoid: install, uninstall

Home organisation: The organisation that made a bot or block and the only one that edits it. German: Heimatorganisation

Organisations and peopleCopy Anchor Link

Instance: One OrcAI installation with its own users and organisations. German: Instanz Avoid: platform, server, deployment

Organisation: A group of members on an instance that owns bots, blocks, assets, providers and quota pools. German: Organisation Avoid: workspace, team, tenant, org, Arbeitsbereich

User: An account on the instance, seen from the instance admin's side. German: Benutzer Avoid: Nutzer

Member: A user who belongs to an organisation, with an organisation role. The organisation's page listing them is Members. German: Mitglied Avoid: user (for someone in an organisation)

People: A mixed list of users and groups, as in the access dialog. German: Personen

Account: A user's own sign-in, profile and settings. A new one is made with Create account. German: Konto, Konto erstellen Avoid: register, sign up

Sign in, Sign out: Start and end a session with an account. German: Anmelden, Abmelden Avoid: log in, log out

Group: A set of members in one organisation that access is granted to at once. All members is the group every member is in. German: Gruppe, Alle Mitglieder

Invitation: An email offer to join an organisation with a role. German: Einladung

Roles and accessCopy Anchor Link

Role: The set of rights a member has in an organisation, or a grant gives on one item. German: Rolle

Admin, Manager, Member, Viewer (organisation roles): What a member can do across the organisation. Viewers chat and read, members also create bots, blocks and assets, managers also run members, groups and catalogue additions, admins also configure providers, models, quota pools and the organisation. German: Admin, Manager, Mitglied, Betrachter Avoid: administrator

Instance admin: A user who manages every organisation and user of the instance. German: Instanz-Admin Avoid: instance administrator

Can view, Can edit, Can manage (resource roles): What a grant allows on one bot, block or asset. German: Kann ansehen, Kann bearbeiten, Kann verwalten Avoid: Viewer, Editor, Manager (those name organisation roles), Bearbeiter

Resource: Not a user-facing word. Name the kind (bot, behaviour, repository, asset) or write "it". Avoid: resource, Ressource

Owner: The member a bot, block or asset belongs to. German: Eigentümer

Hand over: Make another member the owner of a bot, block or asset. Removing a member, making one a Viewer and deleting an account hand over what they own. German: übergeben, „Übergeben an“ for the receiver Avoid: transfer, übertragen

Share: Give people or groups access to a bot, block or asset. German: freigeben, Freigabe Avoid: teilen, geteilt, publish, list

Grant: One record of access: who (a user, a group or all members), on what, with which role. A direct grant is made on the item itself, as opposed to access inherited from a bot, a block or the organisation. German: Freigabe

Revoke: Remove a grant. German: entziehen

Access: Whether someone can see, use or change something. German: Zugriff Avoid: permission (for grants)

Permission: An action an organisation role allows, such as creating bots. German: Berechtigung

Chat and the AssistantCopy Anchor Link

Chat: A thread of messages with a bot or with a model alone. German: Chat Avoid: thread, session, Gespräch

Branch: A copy of a chat up to one message, linked to the chat it came from. German: Zweig

Pin, Unpin: Keep a chat at the top of the chat list. German: Anheften, Lösen

Favourite: Mark a bot to keep it at hand on Home and in the Library. German: Favorit Avoid: star, bookmark

Attachment: A file or asset sent with a single chat message. German: Anhang

Work log: The list of steps a bot or the Assistant took for an answer. German: Arbeitsprotokoll

OrcAI Assistant: The built-in helper that sets up and manages OrcAI for the user through conversation. After the first mention on a page or screen, "the Assistant" with a capital A. German: OrcAI Assistant, der Assistant Avoid: assistant (for a bot or the model), Assistent

Conversation: A thread with the OrcAI Assistant. German: Unterhaltung Avoid: chat (for Assistant threads)

Tour: The guided walkthrough of a screen. German: Tour Avoid: Rundgang

Models and quotaCopy Anchor Link

Provider: A service that runs models or web search, connected with its endpoint and key. German: Anbieter Avoid: connection

Model: A language model from a provider that an organisation has enabled. German: Modell

Chat model: The model a chat answers with. German: Chat-Modell

Default chat model: The organisation's model that new chats start on unless their bot or the person chooses another. German: Standard-Chat-Modell

Utility model: The organisation's model for background work: chat titles, image descriptions, metadata. German: Hilfsmodell

Assistant model: The model the OrcAI Assistant runs on. German: Assistant-Modell

Capability: Something a model can do, such as reading images or calling tools. German: Fähigkeit

Bot setup: The model and settings an organisation chooses for a bot, as recommended or required. The only thing called "setup". Making a new bot is Create bot. German: Bot-Einrichtung Avoid: setup for anything else

Quota pool: A budget for model use that resets each period and covers some groups and models. After the first mention, "pool". The navigation and the index page say Quota pools. German: Kontingent-Pool, Pool Avoid: quota (alone, for the pool), Quotas, allowance, credits, Guthaben

Budget: The amount a quota pool may spend per period. What is left of it is the remaining budget. German: Budget, verbleibendes Budget

Usage: What a person, bot or model consumed, in tokens or cost. German: Nutzung

Web search: A feature that lets a chat search the web, through a search provider or the model's own search, depending on the organisation's setting. German: Websuche

Search provider: A provider that runs web searches, when the organisation's web search setting uses one instead of the model's own search. German: Suchanbieter

Allowed domains: The host names web search is limited to, subdomains included. An empty list allows the whole web. German: Erlaubte Domains

Instance operationsCopy Anchor Link

Health: The instance page that shows whether services, workers and checks are working. German: Status

Readiness checklist: The list of steps an organisation needs before chat works. German: Checkliste zur Einrichtung Avoid: setup checklist, Einrichtungs-Checkliste, "Organisation setup" as the name of the checklist