OrcAI
Using OrcAI

Bots and Behaviour

Build reusable AI experiences with bots, behaviour blocks, and content collections.

Bots are reusable AI configurations that can be selected at chat start. They are authored in the Library area and combine behaviour, retrieval context, and sharing settings.

Library Sections

The Library route includes four major sections:

  • Bots
  • Behaviour
  • Repositories
  • Content

Core Concepts

  • Bots: named AI setups users can select when starting a chat.
  • Blocks: reusable building blocks used by bots and chats.
  • Behaviour blocks: template or image-generation blocks used to define response style/logic.
  • Repository blocks: database blocks that package content and retrieval settings.
  • Content items: uploaded assets that can be attached to repository blocks and chats.

Bot Lifecycle

Bots have draft and published states:

  • Published bots appear as ready-to-use options for chat setup.
  • Draft bots appear in Your Drafts and can be edited or deleted (depending on capabilities).

Creating Or Editing A Bot

The bot editor is a guided wizard with five steps:

Bot Basics [step]

Name the bot and define the high-level metadata users will see.

AI Behaviour [step]

Choose or create the behaviour block that controls the bot's response style and instructions.

Content [step]

Attach ready repository blocks that provide retrieval context.

Sharing And Access [step]

Configure visibility, groups, and direct grants for the intended audience.

Review And Launch [step]

Review validation results and publish when the bot is ready.

The editor supports:

  • Creating new blocks inline
  • Linking existing blocks from block libraries
  • Persisting linked blocks while progressing
  • Publishing when validation rules pass

Publish Readiness Rules

From current editor behaviour, launching requires:

  • A template behaviour block exists
  • Template behaviour block status is Ready
  • Every linked database block status is Ready
  • Every linked database block has at least one attached asset

Block Types

The block creation flow currently supports three types:

  • Template block (AI Behaviour)
  • Database block (Content Collection / Repository)
  • Image Generation block

Each block can have:

  • Draft or Ready status
  • Metadata and versioning
  • Visibility and grants
  • Capability-based actions (edit, delete, manage access)

Repository Playground

Ready database blocks expose a playground where users can test retrieval queries directly against that repository.

This is useful for:

  • Validating chunk quality
  • Verifying retrieval mode behaviour
  • Debugging missing or low-quality results before attaching to bots

Sharing And Access

Bots and blocks expose access dialogs for visibility, groups, and direct grants.

The same patterns are reused across assets, blocks, and bots.

TODO

Document the exact share permission matrix for bot use vs bot edit, confirm whether image-generation blocks can be attached to bot runtime today, and add an end-to-end bot creation example.

On this page