rag-uid Command Reference

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

f56cf16b02911b8665c78a5c55c5f9e563e82a056a42725e0000000100000363

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

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

SYNOPSIS
--------
[verse]
'rag uid' [--abbrev <n=64>]

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 Reference

Summary

The rag-uid command displays the unique identifier of a knowledge-base, calculated based on chunks, images, and meta, with caching for efficiency, and is only updated when the knowledge-base is modified, excluding changes to configurations or prompts.