From f339f7608c5b1b7592b5075ac4340fd0ce40da7f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Iv=C3=A1n=20Mart=C3=ADnez?= Date: Thu, 16 Nov 2023 23:25:14 +0100 Subject: [PATCH] Move Docs to Fern (#1257) --- .github/workflows/fern/fern-check.yml | 19 + .github/workflows/fern/preview-docs.yml | 46 + .github/workflows/fern/publish-docs.yml | 24 + fern/docs.yml | 48 ++ fern/docs/assets/favicon.ico | Bin 0 -> 15406 bytes fern/docs/assets/header.jpeg | Bin 0 -> 29566 bytes fern/docs/assets/logo_dark.png | Bin 0 -> 2658 bytes fern/docs/assets/logo_light.png | Bin 0 -> 7445 bytes fern/docs/pages/ingestion.mdx | 37 + fern/docs/pages/installation.mdx | 235 ++++++ fern/docs/pages/llms.mdx | 83 ++ fern/docs/pages/quickstart.mdx | 38 + fern/docs/pages/sdks.mdx | 36 + fern/docs/pages/ui.mdx | 39 + fern/docs/pages/vectordb.mdx | 30 + fern/docs/pages/welcome.mdx | 42 + fern/fern.config.json | 4 + fern/generators.yml | 8 + fern/openapi/openapi.json | 1024 +++++++++++++++++++++++ 19 files changed, 1713 insertions(+) create mode 100644 .github/workflows/fern/fern-check.yml create mode 100644 .github/workflows/fern/preview-docs.yml create mode 100644 .github/workflows/fern/publish-docs.yml create mode 100644 fern/docs.yml create mode 100644 fern/docs/assets/favicon.ico create mode 100644 fern/docs/assets/header.jpeg create mode 100644 fern/docs/assets/logo_dark.png create mode 100644 fern/docs/assets/logo_light.png create mode 100644 fern/docs/pages/ingestion.mdx create mode 100644 fern/docs/pages/installation.mdx create mode 100644 fern/docs/pages/llms.mdx create mode 100644 fern/docs/pages/quickstart.mdx create mode 100644 fern/docs/pages/sdks.mdx create mode 100644 fern/docs/pages/ui.mdx create mode 100644 fern/docs/pages/vectordb.mdx create mode 100644 fern/docs/pages/welcome.mdx create mode 100644 fern/fern.config.json create mode 100644 fern/generators.yml create mode 100644 fern/openapi/openapi.json diff --git a/.github/workflows/fern/fern-check.yml b/.github/workflows/fern/fern-check.yml new file mode 100644 index 0000000..3f7ac74 --- /dev/null +++ b/.github/workflows/fern/fern-check.yml @@ -0,0 +1,19 @@ +name: fern check + +on: + pull_request: + branches: + - main + +jobs: + fern-check: + runs-on: ubuntu-latest + steps: + - name: Checkout repo + uses: actions/checkout@v4 + + - name: Install Fern + run: npm install -g fern-api + + - name: Check Fern API is valid + run: fern check \ No newline at end of file diff --git a/.github/workflows/fern/preview-docs.yml b/.github/workflows/fern/preview-docs.yml new file mode 100644 index 0000000..ce89953 --- /dev/null +++ b/.github/workflows/fern/preview-docs.yml @@ -0,0 +1,46 @@ +name: deploy preview docs + +on: + pull_request: + branches: + - main + +jobs: + preview-docs: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + - name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: "18" + + - name: Install Fern + run: npm install -g fern-api + + - name: Generate Documentation Preview with Fern + id: generate_docs + env: + FERN_TOKEN: ${{ secrets.FERN_TOKEN }} + run: | + output=$(fern generate --docs --preview) + echo "$output" + # Extract the URL + preview_url=$(echo "$output" | grep -oP '(?<=Published docs to )https://[^\s]*') + # Set the output for the step + echo "::set-output name=preview_url::$preview_url" + - name: Comment PR with URL using github-actions bot + uses: actions/github-script@v4 + if: ${{ steps.generate_docs.outputs.preview_url }} + with: + script: | + const preview_url = '${{ steps.generate_docs.outputs.preview_url }}'; + const issue_number = context.issue.number; + github.issues.createComment({ + ...context.repo, + issue_number: issue_number, + body: `Published docs preview URL: ${preview_url}` + }) diff --git a/.github/workflows/fern/publish-docs.yml b/.github/workflows/fern/publish-docs.yml new file mode 100644 index 0000000..7441d14 --- /dev/null +++ b/.github/workflows/fern/publish-docs.yml @@ -0,0 +1,24 @@ +name: publish docs + +on: + push: + branches: + - main + +jobs: + publish-docs: + runs-on: ubuntu-latest + steps: + - name: Checkout repo + uses: actions/checkout@v4 + + - name: Setup node + uses: actions/setup-node@v3 + + - name: Download Fern + run: npm install -g fern-api + + - name: Generate and Publish Docs + env: + FERN_TOKEN: ${{ secrets.FERN_TOKEN }} + run: fern generate --docs --log-level debug diff --git a/fern/docs.yml b/fern/docs.yml new file mode 100644 index 0000000..d01be58 --- /dev/null +++ b/fern/docs.yml @@ -0,0 +1,48 @@ +instances: + - url: privategpt.docs.buildwithfern.com + custom-domain: docs.privategpt.dev + +title: PrivateGPT | Docs + +navigation: + - section: Getting started + contents: + - page: Welcome + path: ./docs/pages/welcome.mdx + - page: Quickstart + path: ./docs/pages/quickstart.mdx + - page: Installation + path: ./docs/pages/installation.mdx + - page: LLMs + path: ./docs/pages/llms.mdx + - page: Vector Stores + path: ./docs/pages/vectordb.mdx + - section: Usage + contents: + - page: UI manual + path: ./docs/pages/ui.mdx + - page: Ingestion & Doc mgmt + path: ./docs/pages/ingestion.mdx + - page: SDKs + path: ./docs/pages/sdks.mdx + - api: API Reference + +navbar-links: + - type: secondary + text: Contact us + url: "mailto:hello@zylon.ai" + - type: primary + text: Join the Discord + url: https://discord.com/invite/bK6mRVpErU + +colors: + accentPrimary: + dark: "#C6BBFF" + light: "#756E98" + +logo: + dark: ./docs/assets/logo_light.png + light: ./docs/assets/logo_dark.png + height: 50 + +favicon: ./docs/assets/favicon.ico diff --git a/fern/docs/assets/favicon.ico b/fern/docs/assets/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..ab220adb2ff076d74bac45104f3c068b85e7aecd GIT binary patch literal 15406 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 F{tMXj*>eB@ literal 0 HcmV?d00001 diff --git a/fern/docs/assets/header.jpeg b/fern/docs/assets/header.jpeg new file mode 100644 index 0000000000000000000000000000000000000000..b67c56d82fb4bb9b15096e4b80db8427a0b92920 GIT binary patch literal 29566 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 U!a}=uuF@4@X{FxENZ&2|FGFCIDgXcg literal 0 HcmV?d00001 diff --git a/fern/docs/assets/logo_dark.png b/fern/docs/assets/logo_dark.png new file mode 100644 index 0000000000000000000000000000000000000000..ec7164708a9ef1511d5f0c83baf28f120e3db274 GIT binary patch literal 2658 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 DkrwUH literal 0 HcmV?d00001 diff --git a/fern/docs/assets/logo_light.png b/fern/docs/assets/logo_light.png new file mode 100644 index 0000000000000000000000000000000000000000..8819056c5168a7a07fe52619e1d3ec6d535bfa6a GIT binary patch literal 7445 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 literal 0 HcmV?d00001 diff --git a/fern/docs/pages/ingestion.mdx b/fern/docs/pages/ingestion.mdx new file mode 100644 index 0000000..49671fa --- /dev/null +++ b/fern/docs/pages/ingestion.mdx @@ -0,0 +1,37 @@ +## Ingesting & Managing Documents + +The ingestion of documents can be done in different ways: + +* Using the `/ingest` API +* Using the Gradio UI +* Using the Bulk Local Ingestion functionality (check next section) + +### Bulk Local Ingestion + +When you are running PrivateGPT in a fully local setup, you can ingest a complete folder for convenience (containing +pdf, text files, etc.) +and optionally watch changes on it with the command: + +```bash +make ingest /path/to/folder -- --watch +``` + +To log the processed and failed files to an additional file, use: + +```bash +make ingest /path/to/folder -- --watch --log-file /path/to/log/file.log +``` + +After ingestion is complete, you should be able to chat with your documents +by navigating to http://localhost:8001 and using the option `Query documents`, +or using the completions / chat API. + +### Reset Local documents database + +When running in a local setup, you can remove all ingested documents by simply +deleting all contents of `local_data` folder (except .gitignore). + +To simplify this process, you can use the command: +```bash +make wipe +``` \ No newline at end of file diff --git a/fern/docs/pages/installation.mdx b/fern/docs/pages/installation.mdx new file mode 100644 index 0000000..1395c2b --- /dev/null +++ b/fern/docs/pages/installation.mdx @@ -0,0 +1,235 @@ +## Installation and Settings + +### Base requirements to run PrivateGPT + +* Git clone PrivateGPT repository, and navigate to it: + +```bash + git clone https://github.com/imartinez/privateGPT + cd privateGPT +``` + +* Install Python 3.11. Ideally through a python version manager like `pyenv`. + Python 3.12 + should work too. Earlier python versions are not supported. + * osx/linux: [pyenv](https://github.com/pyenv/pyenv) + * windows: [pyenv-win](https://github.com/pyenv-win/pyenv-win) + +```bash +pyenv install 3.11 +pyenv local 3.11 +``` + +* Install [Poetry](https://python-poetry.org/docs/#installing-with-the-official-installer) for dependency management: + +* Have a valid C++ compiler like gcc. See [Troubleshooting: C++ Compiler](#troubleshooting-c-compiler) for more details. + +* Install `make` for scripts: + * osx: (Using homebrew): `brew install make` + * windows: (Using chocolatey) `choco install make` + +### Install dependencies + +Install the dependencies: + +```bash +poetry install --with ui +``` + +Verify everything is working by running `make run` (or `poetry run python -m private_gpt`) and navigate to +http://localhost:8001. You should see a [Gradio UI](https://gradio.app/) **configured with a mock LLM** that will +echo back the input. Later we'll see how to configure a real LLM. + +### Settings + + +The default settings of PrivateGPT work out-of-the-box for a 100% local setup. Skip this section if you just want to test PrivateGPT locally, and come back later to learn about more configuration options. + + +
+ +PrivateGPT is configured through *profiles* that are defined using yaml files, and selected through env variables. The full list of properties configurable can be found in `settings.yaml` + +#### env var `PGPT_SETTINGS_FOLDER` + +The location of the settings folder. Defaults to the root of the project. +Should contain the default `settings.yaml` and any other `settings-{profile}.yaml`. + +#### env var `PGPT_PROFILES` + +By default, the profile definition in `settings.yaml` is loaded. +Using this env var you can load additional profiles; format is a comma separated list of profile names. +This will merge `settings-{profile}.yaml` on top of the base settings file. + +For example: +`PGPT_PROFILES=local,cuda` will load `settings-local.yaml` +and `settings-cuda.yaml`, their contents will be merged with +later profiles properties overriding values of earlier ones like `settings.yaml`. + +During testing, the `test` profile will be active along with the default, therefore `settings-test.yaml` +file is required. + +#### Environment variables expansion + +Configuration files can contain environment variables, +they will be expanded at runtime. + +Expansion must follow the pattern `${VARIABLE_NAME:default_value}`. + +For example, the following configuration will use the value of the `PORT` +environment variable or `8001` if it's not set. +Missing variables with no default will produce an error. + +```yaml +server: + port: ${PORT:8001} +``` + +### Local LLM requirements + +Install extra dependencies for local execution: + +```bash +poetry install --with local +``` + +For PrivateGPT to run fully locally GPU acceleration is required +(CPU execution is possible, but very slow), however, +typical Macbook laptops or window desktops with mid-range GPUs lack VRAM to run +even the smallest LLMs. For that reason +**local execution is only supported for models compatible with [llama.cpp](https://github.com/ggerganov/llama.cpp)** + +These two models are known to work well: + +* https://huggingface.co/TheBloke/Llama-2-7B-chat-GGUF +* https://huggingface.co/TheBloke/Mistral-7B-Instruct-v0.1-GGUF (recommended) + +To ease the installation process, use the `setup` script that will download both +the embedding and the LLM model and place them in the correct location (under `models` folder): + +```bash +poetry run python scripts/setup +``` + +If you are ok with CPU execution, you can skip the rest of this section. + +As stated before, llama.cpp is required and in +particular [llama-cpp-python](https://github.com/abetlen/llama-cpp-python) +is used. + +> It's highly encouraged that you fully read llama-cpp and llama-cpp-python documentation relevant to your platform. +> Running into installation issues is very likely, and you'll need to troubleshoot them yourself. + +#### Customizing low level parameters + +Currently not all the parameters of llama-cpp and llama-cpp-python are available at PrivateGPT's `settings.yaml` file. In case you need to customize parameters such as the number of layers loaded into the GPU, you might change these at the `llm_component.py` file under the `private_gpt/components/llm/llm_component.py`. If you are getting an out of memory error, you might also try a smaller model or stick to the proposed recommended models, instead of custom tuning the parameters. + +#### OSX GPU support + +You will need to build [llama.cpp](https://github.com/ggerganov/llama.cpp) with +metal support. To do that run: + +```bash +CMAKE_ARGS="-DLLAMA_METAL=on" pip install --force-reinstall --no-cache-dir llama-cpp-python +``` + +#### Windows NVIDIA GPU support + +Windows GPU support is done through CUDA. +Follow the instructions on the original [llama.cpp](https://github.com/ggerganov/llama.cpp) repo to install the required +dependencies. + +Some tips to get it working with an NVIDIA card and CUDA (Tested on Windows 10 with CUDA 11.5 RTX 3070): + +* Install latest VS2022 (and build tools) https://visualstudio.microsoft.com/vs/community/ +* Install CUDA toolkit https://developer.nvidia.com/cuda-downloads +* Verify your installation is correct by running `nvcc --version` and `nvidia-smi`, ensure your CUDA version is up to + date and your GPU is detected. +* [Optional] Install CMake to troubleshoot building issues by compiling llama.cpp directly https://cmake.org/download/ + +If you have all required dependencies properly configured running the +following powershell command should succeed. + +```powershell +$env:CMAKE_ARGS='-DLLAMA_CUBLAS=on'; poetry run pip install --force-reinstall --no-cache-dir llama-cpp-python +``` + +If your installation was correct, you should see a message similar to the following next +time you start the server `BLAS = 1`. + +``` +llama_new_context_with_model: total VRAM used: 4857.93 MB (model: 4095.05 MB, context: 762.87 MB) +AVX = 1 | AVX2 = 1 | AVX512 = 0 | AVX512_VBMI = 0 | AVX512_VNNI = 0 | FMA = 1 | NEON = 0 | ARM_FMA = 0 | F16C = 1 | FP16_VA = 0 | WASM_SIMD = 0 | BLAS = 1 | SSE3 = 1 | SSSE3 = 0 | VSX = 0 | +``` + +Note that llama.cpp offloads matrix calculations to the GPU but the performance is +still hit heavily due to latency between CPU and GPU communication. You might need to tweak +batch sizes and other parameters to get the best performance for your particular system. + +#### Linux NVIDIA GPU support and Windows-WSL + +Linux GPU support is done through CUDA. +Follow the instructions on the original [llama.cpp](https://github.com/ggerganov/llama.cpp) repo to install the required +external +dependencies. + +Some tips: + +* Make sure you have an up-to-date C++ compiler +* Install CUDA toolkit https://developer.nvidia.com/cuda-downloads +* Verify your installation is correct by running `nvcc --version` and `nvidia-smi`, ensure your CUDA version is up to + date and your GPU is detected. + +After that running the following command in the repository will install llama.cpp with GPU support: + +```bash +CMAKE_ARGS='-DLLAMA_CUBLAS=on' poetry run pip install --force-reinstall --no-cache-dir llama-cpp-python +``` + +If your installation was correct, you should see a message similar to the following next +time you start the server `BLAS = 1`. + +``` +llama_new_context_with_model: total VRAM used: 4857.93 MB (model: 4095.05 MB, context: 762.87 MB) +AVX = 1 | AVX2 = 1 | AVX512 = 0 | AVX512_VBMI = 0 | AVX512_VNNI = 0 | FMA = 1 | NEON = 0 | ARM_FMA = 0 | F16C = 1 | FP16_VA = 0 | WASM_SIMD = 0 | BLAS = 1 | SSE3 = 1 | SSSE3 = 0 | VSX = 0 | +``` + +#### Known issues and Troubleshooting + +Execution of LLMs locally still has a lot of sharp edges, specially when running on non Linux platforms. +You might encounter several issues: + +* Performance: RAM or VRAM usage is very high, your computer might experience slowdowns or even crashes. +* GPU Virtualization on Windows and OSX: Simply not possible with docker desktop, you have to run the server directly on + the host. +* Building errors: Some of PrivateGPT dependencies need to build native code, and they might fail on some platforms. + Most likely you are missing some dev tools in your machine (updated C++ compiler, CUDA is not on PATH, etc.). + If you encounter any of these issues, please open an issue and we'll try to help. + +#### Troubleshooting: C++ Compiler + +If you encounter an error while building a wheel during the `pip install` process, you may need to install a C++ +compiler on your computer. + +**For Windows 10/11** + +To install a C++ compiler on Windows 10/11, follow these steps: + +1. Install Visual Studio 2022. +2. Make sure the following components are selected: + * Universal Windows Platform development + * C++ CMake tools for Windows +3. Download the MinGW installer from the [MinGW website](https://sourceforge.net/projects/mingw/). +4. Run the installer and select the `gcc` component. + +** For OSX ** + +1. Check if you have a C++ compiler installed, Xcode might have done it for you. for example running `gcc`. +2. If not, you can install clang or gcc with homebrew `brew install gcc` + +#### Troubleshooting: Mac Running Intel + +When running a Mac with Intel hardware (not M1), you may run into _clang: error: the clang compiler does not support ' +-march=native'_ during pip install. + +If so set your archflags during pip install. eg: _ARCHFLAGS="-arch x86_64" pip3 install -r requirements.txt_ \ No newline at end of file diff --git a/fern/docs/pages/llms.mdx b/fern/docs/pages/llms.mdx new file mode 100644 index 0000000..6dbb4a6 --- /dev/null +++ b/fern/docs/pages/llms.mdx @@ -0,0 +1,83 @@ +## Running the Server + +PrivateGPT supports running with different LLMs & setups. + +### Local models + +Both the LLM and the Embeddings model will run locally. + +Make sure you have followed the *Local LLM requirements* section before moving on. + +This command will start PrivateGPT using the `settings.yaml` (default profile) together with the `settings-local.yaml` +configuration files. By default, it will enable both the API and the Gradio UI. Run: + +```bash +PGPT_PROFILES=local make run +``` + +or + +```bash +PGPT_PROFILES=local poetry run python -m private_gpt +``` + +When the server is started it will print a log *Application startup complete*. +Navigate to http://localhost:8001 to use the Gradio UI or to http://localhost:8001/docs (API section) to try the API +using Swagger UI. + +### Using OpenAI + +If you cannot run a local model (because you don't have a GPU, for example) or for testing purposes, you may +decide to run PrivateGPT using OpenAI as the LLM and Embeddings model. + +In order to do so, create a profile `settings-openai.yaml` with the following contents: + +```yaml +llm: + mode: openai + +openai: + api_key: # You could skip this configuration and use the OPENAI_API_KEY env var instead +``` + +And run PrivateGPT loading that profile you just created: + +`PGPT_PROFILES=openai make run` + +or + +`PGPT_PROFILES=openai poetry run python -m private_gpt` + +When the server is started it will print a log *Application startup complete*. +Navigate to http://localhost:8001 to use the Gradio UI or to http://localhost:8001/docs (API section) to try the API. +You'll notice the speed and quality of response is higher, given you are using OpenAI's servers for the heavy +computations. + +### Using AWS Sagemaker + +For a fully private & performant setup, you can choose to have both your LLM and Embeddings model deployed using Sagemaker. + +Note: how to deploy models on Sagemaker is out of the scope of this documentation. + +In order to do so, create a profile `settings-sagemaker.yaml` with the following contents (remember to +update the values of the llm_endpoint_name and embedding_endpoint_name to yours): + +```yaml +llm: + mode: sagemaker + +sagemaker: + llm_endpoint_name: huggingface-pytorch-tgi-inference-2023-09-25-19-53-32-140 + embedding_endpoint_name: huggingface-pytorch-inference-2023-11-03-07-41-36-479 +``` + +And run PrivateGPT loading that profile you just created: + +`PGPT_PROFILES=sagemaker make run` + +or + +`PGPT_PROFILES=sagemaker poetry run python -m private_gpt` + +When the server is started it will print a log *Application startup complete*. +Navigate to http://localhost:8001 to use the Gradio UI or to http://localhost:8001/docs (API section) to try the API. \ No newline at end of file diff --git a/fern/docs/pages/quickstart.mdx b/fern/docs/pages/quickstart.mdx new file mode 100644 index 0000000..ae1b4d0 --- /dev/null +++ b/fern/docs/pages/quickstart.mdx @@ -0,0 +1,38 @@ +## Local Installation steps + +The steps in `Installation and Settings` section are better explained and cover more +setup scenarios. But if you are looking for a quick setup guide, here it is: + +```bash +# Clone the repo +git clone https://github.com/imartinez/privateGPT +cd privateGPT + +# Install Python 3.11 +pyenv install 3.11 +pyenv local 3.11 + +# Install dependencies +poetry install --with ui,local + +# Download Embedding and LLM models +poetry run python scripts/setup + +# (Optional) For Mac with Metal GPU, enable it. Check Installation and Settings section +to know how to enable GPU on other platforms +CMAKE_ARGS="-DLLAMA_METAL=on" pip install --force-reinstall --no-cache-dir llama-cpp-python + +# Run the local server +PGPT_PROFILES=local make run + +# Note: on Mac with Metal you should see a ggml_metal_add_buffer log, stating GPU is +being used + +# Navigate to the UI and try it out! +http://localhost:8001/ +``` + +## API + +As explained in the introduction, the API contains high level APIs (ingestion and chat/completions) and low level APIs +(embeddings and chunk retrieval). In this section the different specific API calls are explained. \ No newline at end of file diff --git a/fern/docs/pages/sdks.mdx b/fern/docs/pages/sdks.mdx new file mode 100644 index 0000000..96e26cb --- /dev/null +++ b/fern/docs/pages/sdks.mdx @@ -0,0 +1,36 @@ +We use [Fern](www.buildwithfern.com) to offer API clients for Node.js, Python, Go, and Java. We recommend using these clients to interact with our endpoints. The clients are kept up to date automatically, so we encourage you to use the latest version. + +## SDKs + +*Coming soon!* + + + + +
+
+ +
+ + + + + + +
diff --git a/fern/docs/pages/ui.mdx b/fern/docs/pages/ui.mdx new file mode 100644 index 0000000..ddc4d04 --- /dev/null +++ b/fern/docs/pages/ui.mdx @@ -0,0 +1,39 @@ +## Gradio UI user manual + +Gradio UI is a ready to use way of testing most of PrivateGPT API functionalities. + +![Gradio PrivateGPT](https://lh3.googleusercontent.com/drive-viewer/AK7aPaD_Hc-A8A9ooMe-hPgm_eImgsbxAjb__8nFYj8b_WwzvL1Gy90oAnp1DfhPaN6yGiEHCOXs0r77W1bYHtPzlVwbV7fMsA=s1600) + +### Execution Modes + +It has 3 modes of execution (you can select in the top-left): + +* Query Docs: uses the context from the + ingested documents to answer the questions posted in the chat. It also takes + into account previous chat messages as context. + * Makes use of `/chat/completions` API with `use_context=true` and no + `context_filter`. +* Search in Docs: fast search that returns the 4 most related text + chunks, together with their source document and page. + * Makes use of `/chunks` API with no `context_filter`, `limit=4` and + `prev_next_chunks=0`. +* LLM Chat: simple, non-contextual chat with the LLM. The ingested documents won't + be taken into account, only the previous messages. + * Makes use of `/chat/completions` API with `use_context=false`. + +### Document Ingestion + +Ingest documents by using the `Upload a File` button. You can check the progress of +the ingestion in the console logs of the server. + +The list of ingested files is shown below the button. + +If you want to delete the ingested documents, refer to *Reset Local documents +database* section in the documentation. + +### Chat + +Normal chat interface, self-explanatory ;) + +You can check the actual prompt being passed to the LLM by looking at the logs of +the server. We'll add better observability in future releases. \ No newline at end of file diff --git a/fern/docs/pages/vectordb.mdx b/fern/docs/pages/vectordb.mdx new file mode 100644 index 0000000..9b18f0d --- /dev/null +++ b/fern/docs/pages/vectordb.mdx @@ -0,0 +1,30 @@ +## Vectorstores +PrivateGPT supports [Chroma](https://www.trychroma.com/), [Qdrant](https://qdrant.tech/) as vectorstore providers. Chroma being the default. + +### Qdrant configuration + +To enable Qdrant, set the `vectorstore.database` property in the `settings.yaml` file to `qdrant` and install the `qdrant` extra. + +```bash +poetry install --extras qdrant +``` + +By default Qdrant tries to connect to an instance at `http://localhost:3000`. + +Qdrant settings can be configured by setting values to the `qdrant` property in the `settings.yaml` file. + +The available configuration options are: +| Field | Description | +|--------------|-------------| +| location | If `:memory:` - use in-memory Qdrant instance. If `str` - use it as a `url` parameter.| +| url | Either host or str of 'Optional[scheme], host, Optional[port], Optional[prefix]'. Eg. `http://localhost:6333` | +| port | Port of the REST API interface. Default: `6333` | +| grpc_port | Port of the gRPC interface. Default: `6334` | +| prefer_grpc | If `true` - use gRPC interface whenever possible in custom methods. | +| https | If `true` - use HTTPS(SSL) protocol.| +| api_key | API key for authentication in Qdrant Cloud.| +| prefix | If set, add `prefix` to the REST URL path. Example: `service/v1` will result in `http://localhost:6333/service/v1/{qdrant-endpoint}` for REST API.| +| timeout | Timeout for REST and gRPC API requests. Default: 5.0 seconds for REST and unlimited for gRPC | +| host | Host name of Qdrant service. If url and host are not set, defaults to 'localhost'.| +| path | Persistence path for QdrantLocal. Eg. `local_data/private_gpt/qdrant`| +| force_disable_check_same_thread | Force disable check_same_thread for QdrantLocal sqlite connection, defaults to True.| \ No newline at end of file diff --git a/fern/docs/pages/welcome.mdx b/fern/docs/pages/welcome.mdx new file mode 100644 index 0000000..f896f80 --- /dev/null +++ b/fern/docs/pages/welcome.mdx @@ -0,0 +1,42 @@ +## Introduction 👋 + +PrivateGPT provides an **API** containing all the building blocks required to build **private, context-aware AI applications**. The API follows and extends OpenAI API standard, and supports both normal and streaming responses. + +## Frequently Visited Resources + + + + + + + +## API Organization + +The API is divided in two logical blocks: + +1. High-level API, abstracting all the complexity of a RAG (Retrieval Augmented Generation) pipeline implementation: + - Ingestion of documents: internally managing document parsing, splitting, metadata extraction, + embedding generation and storage. + - Chat & Completions using context from ingested documents: abstracting the retrieval of context, the prompt + engineering and the response generation. + +2. Low-level API, allowing advanced users to implement their own complex pipelines: + - Embeddings generation: based on a piece of text. + - Contextual chunks retrieval: given a query, returns the most relevant chunks of text from the ingested + documents. + + +A working **Gradio UI client** is provided to test the API, together with a set of useful tools such as bulk model download script, ingestion script, documents folder watch, etc. + \ No newline at end of file diff --git a/fern/fern.config.json b/fern/fern.config.json new file mode 100644 index 0000000..67b8153 --- /dev/null +++ b/fern/fern.config.json @@ -0,0 +1,4 @@ +{ + "organization": "privategpt", + "version": "0.15.0-rc80" +} \ No newline at end of file diff --git a/fern/generators.yml b/fern/generators.yml new file mode 100644 index 0000000..ec3f967 --- /dev/null +++ b/fern/generators.yml @@ -0,0 +1,8 @@ +groups: + public: + generators: + - name: fernapi/fern-python-sdk + version: 0.6.2 + output: + location: local-file-system + path: ../../pgpt-sdk/python diff --git a/fern/openapi/openapi.json b/fern/openapi/openapi.json new file mode 100644 index 0000000..c74ecce --- /dev/null +++ b/fern/openapi/openapi.json @@ -0,0 +1,1024 @@ +{ + "openapi": "3.1.0", + "info": { + "title": "PrivateGPT", + "summary": "PrivateGPT is a production-ready AI project that allows you to ask questions to your documents using the power of Large Language Models (LLMs), even in scenarios without Internet connection. 100% private, no data leaves your execution environment at any point.", + "description": "", + "contact": { + "url": "https://github.com/imartinez/privateGPT" + }, + "license": { + "name": "Apache 2.0", + "url": "https://www.apache.org/licenses/LICENSE-2.0.html" + }, + "version": "0.1.0", + "x-logo": { + "url": "https://lh3.googleusercontent.com/drive-viewer/AK7aPaD_iNlMoTquOBsw4boh4tIYxyEuhz6EtEs8nzq3yNkNAK00xGjE1KUCmPJSk3TYOjcs6tReG6w_cLu1S7L_gPgT9z52iw=s2560" + } + }, + "paths": { + "/v1/completions": { + "post": { + "tags": [ + "Contextual Completions" + ], + "summary": "Completion", + "description": "We recommend most users use our Chat completions API.\n\nGiven a prompt, the model will return one predicted completion. If `use_context`\nis set to `true`, the model will use context coming from the ingested documents\nto create the response. The documents being used can be filtered using the\n`context_filter` and passing the document IDs to be used. Ingested documents IDs\ncan be found using `/ingest/list` endpoint. If you want all ingested documents to\nbe used, remove `context_filter` altogether.\n\nWhen using `'include_sources': true`, the API will return the source Chunks used\nto create the response, which come from the context provided.\n\nWhen using `'stream': true`, the API will return data chunks following [OpenAI's\nstreaming model](https://platform.openai.com/docs/api-reference/chat/streaming):\n```\n{\"id\":\"12345\",\"object\":\"completion.chunk\",\"created\":1694268190,\n\"model\":\"private-gpt\",\"choices\":[{\"index\":0,\"delta\":{\"content\":\"Hello\"},\n\"finish_reason\":null}]}\n```", + "operationId": "prompt_completion_v1_completions_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CompletionsBody" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenAICompletion" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/v1/chat/completions": { + "post": { + "tags": [ + "Contextual Completions" + ], + "summary": "Chat Completion", + "description": "Given a list of messages comprising a conversation, return a response.\n\nIf `use_context` is set to `true`, the model will use context coming\nfrom the ingested documents to create the response. The documents being used can\nbe filtered using the `context_filter` and passing the document IDs to be used.\nIngested documents IDs can be found using `/ingest/list` endpoint. If you want\nall ingested documents to be used, remove `context_filter` altogether.\n\nWhen using `'include_sources': true`, the API will return the source Chunks used\nto create the response, which come from the context provided.\n\nWhen using `'stream': true`, the API will return data chunks following [OpenAI's\nstreaming model](https://platform.openai.com/docs/api-reference/chat/streaming):\n```\n{\"id\":\"12345\",\"object\":\"completion.chunk\",\"created\":1694268190,\n\"model\":\"private-gpt\",\"choices\":[{\"index\":0,\"delta\":{\"content\":\"Hello\"},\n\"finish_reason\":null}]}\n```", + "operationId": "chat_completion_v1_chat_completions_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChatBody" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenAICompletion" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/v1/chunks": { + "post": { + "tags": [ + "Context Chunks" + ], + "summary": "Chunks Retrieval", + "description": "Given a `text`, returns the most relevant chunks from the ingested documents.\n\nThe returned information can be used to generate prompts that can be\npassed to `/completions` or `/chat/completions` APIs. Note: it is usually a very\nfast API, because only the Embeddings model is involved, not the LLM. The\nreturned information contains the relevant chunk `text` together with the source\n`document` it is coming from. It also contains a score that can be used to\ncompare different results.\n\nThe max number of chunks to be returned is set using the `limit` param.\n\nPrevious and next chunks (pieces of text that appear right before or after in the\ndocument) can be fetched by using the `prev_next_chunks` field.\n\nThe documents being used can be filtered using the `context_filter` and passing\nthe document IDs to be used. Ingested documents IDs can be found using\n`/ingest/list` endpoint. If you want all ingested documents to be used,\nremove `context_filter` altogether.", + "operationId": "chunks_retrieval_v1_chunks_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChunksBody" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChunksResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/v1/ingest": { + "post": { + "tags": [ + "Ingestion" + ], + "summary": "Ingest", + "description": "Ingests and processes a file, storing its chunks to be used as context.\n\nThe context obtained from files is later used in\n`/chat/completions`, `/completions`, and `/chunks` APIs.\n\nMost common document\nformats are supported, but you may be prompted to install an extra dependency to\nmanage a specific file type.\n\nA file can generate different Documents (for example a PDF generates one Document\nper page). All Documents IDs are returned in the response, together with the\nextracted Metadata (which is later used to improve context retrieval). Those IDs\ncan be used to filter the context used to create responses in\n`/chat/completions`, `/completions`, and `/chunks` APIs.", + "operationId": "ingest_v1_ingest_post", + "requestBody": { + "content": { + "multipart/form-data": { + "schema": { + "$ref": "#/components/schemas/Body_ingest_v1_ingest_post" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/IngestResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/v1/ingest/list": { + "get": { + "tags": [ + "Ingestion" + ], + "summary": "List Ingested", + "description": "Lists already ingested Documents including their Document ID and metadata.\n\nThose IDs can be used to filter the context used to create responses\nin `/chat/completions`, `/completions`, and `/chunks` APIs.", + "operationId": "list_ingested_v1_ingest_list_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/IngestResponse" + } + } + } + } + } + } + }, + "/v1/ingest/{doc_id}": { + "delete": { + "tags": [ + "Ingestion" + ], + "summary": "Delete Ingested", + "description": "Delete the specified ingested Document.\n\nThe `doc_id` can be obtained from the `GET /ingest/list` endpoint.\nThe document will be effectively deleted from your storage context.", + "operationId": "delete_ingested_v1_ingest__doc_id__delete", + "parameters": [ + { + "name": "doc_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Doc Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/v1/embeddings": { + "post": { + "tags": [ + "Embeddings" + ], + "summary": "Embeddings Generation", + "description": "Get a vector representation of a given input.\n\nThat vector representation can be easily consumed\nby machine learning models and algorithms.", + "operationId": "embeddings_generation_v1_embeddings_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/EmbeddingsBody" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/EmbeddingsResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/health": { + "get": { + "tags": [ + "Health" + ], + "summary": "Health", + "description": "Return ok if the system is up.", + "operationId": "health_health_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HealthResponse" + } + } + } + } + } + } + } + }, + "components": { + "schemas": { + "Body_ingest_v1_ingest_post": { + "properties": { + "file": { + "type": "string", + "format": "binary", + "title": "File" + } + }, + "type": "object", + "required": [ + "file" + ], + "title": "Body_ingest_v1_ingest_post" + }, + "ChatBody": { + "properties": { + "messages": { + "items": { + "$ref": "#/components/schemas/OpenAIMessage" + }, + "type": "array", + "title": "Messages" + }, + "use_context": { + "type": "boolean", + "title": "Use Context", + "default": false + }, + "context_filter": { + "anyOf": [ + { + "$ref": "#/components/schemas/ContextFilter" + }, + { + "type": "null" + } + ] + }, + "include_sources": { + "type": "boolean", + "title": "Include Sources", + "default": true + }, + "stream": { + "type": "boolean", + "title": "Stream", + "default": false + } + }, + "type": "object", + "required": [ + "messages" + ], + "title": "ChatBody", + "examples": [ + { + "context_filter": { + "docs_ids": [ + "c202d5e6-7b69-4869-81cc-dd574ee8ee11" + ] + }, + "include_sources": true, + "messages": [ + { + "content": "How do you fry an egg?", + "role": "user" + } + ], + "stream": false, + "use_context": true + } + ] + }, + "Chunk": { + "properties": { + "object": { + "type": "string", + "enum": [ + "context.chunk" + ], + "title": "Object" + }, + "score": { + "type": "number", + "title": "Score", + "examples": [ + 0.023 + ] + }, + "document": { + "$ref": "#/components/schemas/IngestedDoc" + }, + "text": { + "type": "string", + "title": "Text", + "examples": [ + "Outbound sales increased 20%, driven by new leads." + ] + }, + "previous_texts": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Previous Texts", + "examples": [ + [ + "SALES REPORT 2023", + "Inbound didn't show major changes." + ] + ] + }, + "next_texts": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Next Texts", + "examples": [ + [ + "New leads came from Google Ads campaign.", + "The campaign was run by the Marketing Department" + ] + ] + } + }, + "type": "object", + "required": [ + "object", + "score", + "document", + "text" + ], + "title": "Chunk" + }, + "ChunksBody": { + "properties": { + "text": { + "type": "string", + "title": "Text", + "examples": [ + "Q3 2023 sales" + ] + }, + "context_filter": { + "anyOf": [ + { + "$ref": "#/components/schemas/ContextFilter" + }, + { + "type": "null" + } + ] + }, + "limit": { + "type": "integer", + "title": "Limit", + "default": 10 + }, + "prev_next_chunks": { + "type": "integer", + "title": "Prev Next Chunks", + "default": 0, + "examples": [ + 2 + ] + } + }, + "type": "object", + "required": [ + "text" + ], + "title": "ChunksBody" + }, + "ChunksResponse": { + "properties": { + "object": { + "type": "string", + "enum": [ + "list" + ], + "title": "Object" + }, + "model": { + "type": "string", + "enum": [ + "private-gpt" + ], + "title": "Model" + }, + "data": { + "items": { + "$ref": "#/components/schemas/Chunk" + }, + "type": "array", + "title": "Data" + } + }, + "type": "object", + "required": [ + "object", + "model", + "data" + ], + "title": "ChunksResponse" + }, + "CompletionsBody": { + "properties": { + "prompt": { + "type": "string", + "title": "Prompt" + }, + "use_context": { + "type": "boolean", + "title": "Use Context", + "default": false + }, + "context_filter": { + "anyOf": [ + { + "$ref": "#/components/schemas/ContextFilter" + }, + { + "type": "null" + } + ] + }, + "include_sources": { + "type": "boolean", + "title": "Include Sources", + "default": true + }, + "stream": { + "type": "boolean", + "title": "Stream", + "default": false + } + }, + "type": "object", + "required": [ + "prompt" + ], + "title": "CompletionsBody", + "examples": [ + { + "include_sources": false, + "prompt": "How do you fry an egg?", + "stream": false, + "use_context": false + } + ] + }, + "ContextFilter": { + "properties": { + "docs_ids": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Docs Ids", + "examples": [ + [ + "c202d5e6-7b69-4869-81cc-dd574ee8ee11" + ] + ] + } + }, + "type": "object", + "required": [ + "docs_ids" + ], + "title": "ContextFilter" + }, + "Embedding": { + "properties": { + "index": { + "type": "integer", + "title": "Index" + }, + "object": { + "type": "string", + "enum": [ + "embedding" + ], + "title": "Object" + }, + "embedding": { + "items": { + "type": "number" + }, + "type": "array", + "title": "Embedding", + "examples": [ + [ + 0.0023064255, + -0.009327292 + ] + ] + } + }, + "type": "object", + "required": [ + "index", + "object", + "embedding" + ], + "title": "Embedding" + }, + "EmbeddingsBody": { + "properties": { + "input": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ], + "title": "Input" + } + }, + "type": "object", + "required": [ + "input" + ], + "title": "EmbeddingsBody" + }, + "EmbeddingsResponse": { + "properties": { + "object": { + "type": "string", + "enum": [ + "list" + ], + "title": "Object" + }, + "model": { + "type": "string", + "enum": [ + "private-gpt" + ], + "title": "Model" + }, + "data": { + "items": { + "$ref": "#/components/schemas/Embedding" + }, + "type": "array", + "title": "Data" + } + }, + "type": "object", + "required": [ + "object", + "model", + "data" + ], + "title": "EmbeddingsResponse" + }, + "HTTPValidationError": { + "properties": { + "detail": { + "items": { + "$ref": "#/components/schemas/ValidationError" + }, + "type": "array", + "title": "Detail" + } + }, + "type": "object", + "title": "HTTPValidationError" + }, + "HealthResponse": { + "properties": { + "status": { + "type": "string", + "enum": [ + "ok" + ], + "title": "Status" + } + }, + "type": "object", + "required": [ + "status" + ], + "title": "HealthResponse" + }, + "IngestResponse": { + "properties": { + "object": { + "type": "string", + "enum": [ + "list" + ], + "title": "Object" + }, + "model": { + "type": "string", + "enum": [ + "private-gpt" + ], + "title": "Model" + }, + "data": { + "items": { + "$ref": "#/components/schemas/IngestedDoc" + }, + "type": "array", + "title": "Data" + } + }, + "type": "object", + "required": [ + "object", + "model", + "data" + ], + "title": "IngestResponse" + }, + "IngestedDoc": { + "properties": { + "object": { + "type": "string", + "enum": [ + "ingest.document" + ], + "title": "Object" + }, + "doc_id": { + "type": "string", + "title": "Doc Id", + "examples": [ + "c202d5e6-7b69-4869-81cc-dd574ee8ee11" + ] + }, + "doc_metadata": { + "anyOf": [ + { + "type": "object" + }, + { + "type": "null" + } + ], + "title": "Doc Metadata", + "examples": [ + { + "file_name": "Sales Report Q3 2023.pdf", + "page_label": "2" + } + ] + } + }, + "type": "object", + "required": [ + "object", + "doc_id", + "doc_metadata" + ], + "title": "IngestedDoc" + }, + "OpenAIChoice": { + "properties": { + "finish_reason": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Finish Reason", + "examples": [ + "stop" + ] + }, + "delta": { + "anyOf": [ + { + "$ref": "#/components/schemas/OpenAIDelta" + }, + { + "type": "null" + } + ] + }, + "message": { + "anyOf": [ + { + "$ref": "#/components/schemas/OpenAIMessage" + }, + { + "type": "null" + } + ] + }, + "sources": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Chunk" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Sources" + }, + "index": { + "type": "integer", + "title": "Index", + "default": 0 + } + }, + "type": "object", + "required": [ + "finish_reason" + ], + "title": "OpenAIChoice", + "description": "Response from AI.\n\nEither the delta or the message will be present, but never both.\nSources used will be returned in case context retrieval was enabled." + }, + "OpenAICompletion": { + "properties": { + "id": { + "type": "string", + "title": "Id" + }, + "object": { + "type": "string", + "enum": [ + "completion", + "completion.chunk" + ], + "title": "Object", + "default": "completion" + }, + "created": { + "type": "integer", + "title": "Created", + "examples": [ + 1623340000 + ] + }, + "model": { + "type": "string", + "enum": [ + "private-gpt" + ], + "title": "Model" + }, + "choices": { + "items": { + "$ref": "#/components/schemas/OpenAIChoice" + }, + "type": "array", + "title": "Choices" + } + }, + "type": "object", + "required": [ + "id", + "created", + "model", + "choices" + ], + "title": "OpenAICompletion", + "description": "Clone of OpenAI Completion model.\n\nFor more information see: https://platform.openai.com/docs/api-reference/chat/object" + }, + "OpenAIDelta": { + "properties": { + "content": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Content" + } + }, + "type": "object", + "required": [ + "content" + ], + "title": "OpenAIDelta", + "description": "A piece of completion that needs to be concatenated to get the full message." + }, + "OpenAIMessage": { + "properties": { + "role": { + "type": "string", + "enum": [ + "assistant", + "system", + "user" + ], + "title": "Role", + "default": "user" + }, + "content": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Content" + } + }, + "type": "object", + "required": [ + "content" + ], + "title": "OpenAIMessage", + "description": "Inference result, with the source of the message.\n\nRole could be the assistant or system\n(providing a default response, not AI generated)." + }, + "ValidationError": { + "properties": { + "loc": { + "items": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + } + ] + }, + "type": "array", + "title": "Location" + }, + "msg": { + "type": "string", + "title": "Message" + }, + "type": { + "type": "string", + "title": "Error Type" + } + }, + "type": "object", + "required": [ + "loc", + "msg", + "type" + ], + "title": "ValidationError" + } + } + }, + "tags": [ + { + "name": "Ingestion", + "description": "High-level APIs covering document ingestion -internally managing document parsing, splitting,metadata extraction, embedding generation and storage- and ingested documents CRUD.Each ingested document is identified by an ID that can be used to filter the contextused in *Contextual Completions* and *Context Chunks* APIs." + }, + { + "name": "Contextual Completions", + "description": "High-level APIs covering contextual Chat and Completions. They follow OpenAI's format, extending it to allow using the context coming from ingested documents to create the response. Internallymanage context retrieval, prompt engineering and the response generation." + }, + { + "name": "Context Chunks", + "description": "Low-level API that given a query return relevant chunks of text coming from the ingesteddocuments." + }, + { + "name": "Embeddings", + "description": "Low-level API to obtain the vector representation of a given text, using an Embeddings model.Follows OpenAI's embeddings API format." + }, + { + "name": "Health", + "description": "Simple health API to make sure the server is up and running." + } + ] + } \ No newline at end of file