> This page is for version v0.25.0.
> For other versions, use one of these documentation indexes:
> - Latest (default): https://docs.nvidia.com/nemo/guardrails/latest/llms.txt
> - v0.25.0: https://docs.nvidia.com/nemo/guardrails/v0.25.0/llms.txt
> - v0.24.1: https://docs.nvidia.com/nemo/guardrails/v0.24.1/llms.txt
> - v0.24.0: https://docs.nvidia.com/nemo/guardrails/v0.24.0/llms.txt
> - v0.23.0: https://docs.nvidia.com/nemo/guardrails/v0.23.0/llms.txt
> - v0.22.0: https://docs.nvidia.com/nemo/guardrails/v0.22.0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/llms.txt.

# nemoguardrails.actions.retrieve_relevant_chunks

## Module Contents

### Functions

| Name                                                                                                    | Description                                                |
| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [`retrieve_relevant_chunks`](#nemoguardrails-actions-retrieve_relevant_chunks-retrieve_relevant_chunks) | Retrieve relevant knowledge chunks and update the context. |

### Data

[`log`](#nemoguardrails-actions-retrieve_relevant_chunks-log)

### API

```python
nemoguardrails.actions.retrieve_relevant_chunks.retrieve_relevant_chunks(
    context: typing.Optional[dict] = None,
    kb: typing.Optional[nemoguardrails.kb.kb.KnowledgeBase] = None,
    is_colang_2: typing.Optional[bool] = False
)
```

async

Retrieve relevant knowledge chunks and update the context.

**Example**

```python
result = await retrieve_relevant_chunks(context=my_context, kb=my_knowledge_base)
print(result.return_value)  # Relevant chunks as a string
print(result.context_updates)  # Updated context with relevant chunks
```

**Parameters:**

**`context`** `Optional[dict]` — default: None

The context for the execution of the action. Defaults to None.

---

**`kb`** `Optional[KnowledgeBase]` — default: None

`Optional[` [`KnowledgeBase`](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/kb/kb#nemoguardrails-kb-kb-KnowledgeBase) `]` — The KnowledgeBase to search for relevant chunks. Defaults to None.

---

**Returns:**

An action result containing the retrieved relevant chunks with context updates:

* "relevant_chunks" -- the relevant chunks as a single string,
* "relevant_chunks_sep" -- the relevant chunks as a list of strings before concatenation,
* "retrieved_for" -- the user message that the chunks were retrieved for.

> **Note**
>
> This action retrieves relevant chunks from the KnowledgeBase based on the user's last message
> and updates the context with the information.

```python
nemoguardrails.actions.retrieve_relevant_chunks.log = logging.getLogger(__name__)
```