rag-uid Command Overview

1st chunk of `docs/commands/uid.txt`

d07e3cc5fc743a71c85ea6139073c8839615453dfd2a95990000000100000351

rag-uid(1)
==========

NAME
----
rag-uid - Display uid of the knowledge-base.

SYNOPSIS
--------
[verse]
'rag uid'

DESCRIPTION
-----------
A knowledge-base has a uid. It's a unique identifier of the knowledge-base.
When you edit the knowledge-base (e.g. add chunks), the uid will be changed.

The uid only cares about chunks, images and meta. That means changing configs
or prompts will not change the uid. If you want to push a knowledge-base after
changing configs, I recommend you change its meta so that it has different uid.

Unlike git, it takes long time to calculate a uid of a knowledge-base. So it's
calculated lazily. If uid has never been calculated, this command will
calculate and cache the result. Then it'll use the cached data. When you edit
the knowledge-base, the cache will be invalidated and not calculated until you
need uid.

Title: rag-uid Command Overview

Summary

The rag-uid command displays the unique identifier of a knowledge-base, which is calculated based on chunks, images, and meta, and is updated lazily when changes are made to the knowledge-base, providing a way to track and manage different versions of the knowledge-base over time.