Skip to content

Commit a84c1b2

Browse files
Pouyanpicparisien
andauthored
docs: clean up documentation language and references (#1514)
* docs: clean up documentation language and references Co-authored-by: Chris Parisien <64271260+cparisien@users.noreply.github.com> Signed-off-by: Pouyan <13303554+Pouyanpi@users.noreply.github.com> --------- Signed-off-by: Pouyan <13303554+Pouyanpi@users.noreply.github.com> Co-authored-by: Chris Parisien <64271260+cparisien@users.noreply.github.com>
1 parent 6c57dea commit a84c1b2

File tree

4 files changed

+4
-29
lines changed

4 files changed

+4
-29
lines changed

README.md

Lines changed: 3 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,13 @@
22

33
[![Tests](https://img.shields.io/badge/Tests-passing-green)](#)
44
[![License](https://img.shields.io/badge/License-Apache%202.0-brightgreen.svg)](https://github.com/NVIDIA/NeMo-Guardrails/blob/main/LICENSE.md)
5-
[![Project Status](https://img.shields.io/badge/Status-beta-orange)](#)
65
[![PyPI version](https://badge.fury.io/py/nemoguardrails.svg)](https://badge.fury.io/py/nemoguardrails)
76
[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-green)](https://www.python.org/downloads/)
87
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
98
[![arXiv](https://img.shields.io/badge/arXiv-2310.10501-b31b1b.svg)](https://arxiv.org/abs/2310.10501)
109

1110
> **LATEST RELEASE / DEVELOPMENT VERSION**: The [main](https://github.com/NVIDIA/NeMo-Guardrails/tree/main) branch tracks the latest released beta version: [0.18.0](https://github.com/NVIDIA/NeMo-Guardrails/tree/v0.18.0). For the latest development version, checkout the [develop](https://github.com/NVIDIA/NeMo-Guardrails/tree/develop) branch.
1211
13-
> **DISCLAIMER**: The beta release is undergoing active development and may be subject to changes and improvements, which could cause instability and unexpected behavior. We currently do not recommend deploying this beta version in a production setting. We appreciate your understanding and contribution during this stage. Your support and feedback are invaluable as we advance toward creating a robust, ready-for-production LLM guardrails toolkit. The examples provided within the documentation are for educational purposes to get started with NeMo Guardrails, and are not meant for use in production applications.
14-
1512
✨✨✨
1613

1714
📌 **The official NeMo Guardrails documentation has moved to [docs.nvidia.com/nemo/guardrails](https://docs.nvidia.com/nemo/guardrails).**
@@ -74,7 +71,6 @@ You can use programmable guardrails in different types of use cases:
7471
2. **Domain-specific Assistants** (a.k.a. chatbots): Ensure the assistant stays on topic and follows the designed conversational flows.
7572
3. **LLM Endpoints**: Add guardrails to your custom LLM for safer customer interaction.
7673
4. **LangChain Chains**: If you use LangChain for any use case, you can add a guardrails layer around your chains.
77-
5. **Agents (COMING SOON)**: Add guardrails to your LLM-based agent.
7874

7975
### Usage
8076

@@ -214,7 +210,7 @@ define flow
214210
To configure and implement various types of guardrails, this toolkit introduces **Colang**, a modeling language specifically created for designing flexible, yet controllable, dialogue flows. Colang has a python-like syntax and is designed to be simple and intuitive, especially for developers.
215211

216212
```{note}
217-
Currently two versions of Colang, 1.0 and 2.0, are supported and Colang 1.0 is the default. Versions 0.1.0 up to 0.7.1 of NeMo Guardrails used Colang 1.0 exclusively. Versions 0.8.0 introduced Colang 2.0-alpha and version 0.9.0 introduced Colang 2.0-beta. We expect Colang 2.0 to go out of Beta and replace 1.0 as the default option in NeMo Guardrails version 0.12.0.
213+
Two versions of Colang, 1.0 and 2.0, are supported and Colang 1.0 is the default.
218214
```
219215

220216
For a brief introduction to the Colang 1.0 syntax, see the [Colang 1.0 Language Syntax Guide](https://docs.nvidia.com/nemo/guardrails/user-guides/colang-language-syntax-guide.html).
@@ -226,23 +222,10 @@ To get started with Colang 2.0, see the [Colang 2.0 Documentation](https://docs.
226222
NeMo Guardrails comes with a set of [built-in guardrails](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html).
227223

228224
```{note}
229-
The built-in guardrails are only intended to enable you to get started quickly with NeMo Guardrails. For production use cases, further development and testing of the rails are needed.
225+
The built-in guardrails may or may not be suitable for a given production use case. As always, developers should work with their internal application team to ensure guardrails meets requirements for the relevant industry and use case and address unforeseen product misuse.
230226
```
231227

232-
Currently, the NeMo Guardrails library includes guardrails for:
233-
234-
- [Jailbreak Detection](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#jailbreak-detection-heuristics)
235-
- [Self-Check Input Moderation](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#self-input-output)
236-
- [Self-Check Output Moderation](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#self-check-output)
237-
- [Self-Check Fact-checking](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#fact-checking)
238-
- [Hallucination Detection](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#hallucination-detection)
239-
- [AlignScore-based Fact-checking](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#alignscore-based-fact-checking)
240-
- [LlamaGuard-based Content Moderation](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#llama-guard-based-content-moderation)
241-
- [RAG hallucination detection using Patronus Lynx](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#patronus-lynx-based-rag-hallucination-detection)
242-
- [Presidio-based Sensitive Data Detection](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#presidio-based-sensitive-data-detection)
243-
- [Input moderation using ActiveFence](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#activefence)
244-
- [RAG Hallucination detection using Got It AI's TruthChecker API](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#got-it-ai)
245-
- [AutoAlign-based guardrails](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html#autoalign)
228+
The library includes guardrails for LLM self-checking (input/output moderation, fact-checking, hallucination detection), NVIDIA safety models (content safety, topic safety), jailbreak and injection detection, and integrations with community models and third-party APIs. For the complete list, see the [Guardrails Library documentation](https://docs.nvidia.com/nemo/guardrails/user-guides/guardrails-library.html).
246229

247230
## CLI
248231

docs/api/nemoguardrails.rails.llm.llmrails.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -108,8 +108,6 @@ The format for messages is the following:
108108
**Returns:**
109109
The completion (when a prompt is provided) or the next message.
110110

111-
System messages are not yet supported.
112-
113111
---
114112

115113
<a href="../../nemoguardrails/rails/llm/llmrails.py#L513"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square" /></a>

docs/user-guides/advanced/generation-options.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -141,8 +141,6 @@ res.log.print_summary()
141141
- [0.31s] OUTPUT (self check output): 1 actions (self_check_output), 1 llm calls [0.31s]
142142
```
143143

144-
**TODO**: add more details about the returned data.
145-
146144
## Disabling Rails
147145

148146
You can choose which categories of rails you want to apply by using the `rails` generation option. The four supported categories are: `input`, `dialog`, `retrieval` and `output`. By default, all are enabled.

docs/user-guides/guardrails-library.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ NeMo Guardrails comes with a library of built-in guardrails that you can easily
1414
- [LlamaGuard-based Content Moderation](#llama-guard-based-content-moderation)
1515
- [Patronus Lynx-based RAG Hallucination Detection](#patronus-lynx-based-rag-hallucination-detection)
1616
- [Presidio-based Sensitive data detection](#presidio-based-sensitive-data-detection)
17-
- BERT-score Hallucination Checking - *[COMING SOON]*
1817

1918
3. Third-Party APIs
2019
- [ActiveFence Moderation](#activefence)
@@ -28,7 +27,6 @@ NeMo Guardrails comes with a library of built-in guardrails that you can easily
2827
- [Prompt Security Protection](#prompt-security-protection)
2928
- [Pangea AI Guard](#pangea-ai-guard)
3029
- [Trend Micro Vision One AI Application Security](#trend-micro-vision-one-ai-application-security)
31-
- OpenAI Moderation API - *[COMING SOON]*
3230
- [Cisco AI Defense](#cisco-ai-defense)
3331

3432
4. Other
@@ -428,7 +426,7 @@ Similar to the self-check fact-checking, we formulate the consistency checking s
428426

429427
## NVIDIA Models
430428

431-
NeMo Guardrails provides out of the box connectivity for safety models trained by the NVIDIA for specialized use cases. These models shall be provided as both as HuggingFace checkpoints, and as NVIDIA NIM containers that will provide out of the box TRTLLM support with lower latency.
429+
NeMo Guardrails provides out of the box connectivity for safety models trained by NVIDIA for specialized use cases. These models are provided as both HuggingFace checkpoints and as NVIDIA NIM containers that provide out of the box TRTLLM support with lower latency.
432430

433431
### Content Safety
434432

@@ -1036,8 +1034,6 @@ Using the default value allows for detection of 49/50 GCG-style attacks with a 0
10361034

10371035
To compute the perplexity of a string, the current implementation uses the `gpt2-large` model.
10381036

1039-
**NOTE**: in future versions, multiple options will be supported.
1040-
10411037
#### Model-based Jailbreak Detections
10421038

10431039
There is currently one available model-based detection, using a random forest-based detector trained on [`Snowflake/snowflake-arctic-embed-m-long`](https://huggingface.co/Snowflake/snowflake-arctic-embed-m-long) embeddings.

0 commit comments

Comments
 (0)