> For the complete documentation index, see [llms.txt](https://docs.aios.foundation/aios-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aios.foundation/aios-docs/aios-kernel/storage/sto_retrieve.md).

# sto\_retrieve

```python
def sto_retrieve(collection_name: str, query_text: str, k: str = 3, keywords: str = None) -> list
```

[Source code](https://github.com/agiresearch/AIOS/blob/main/aios/storage/filesystem/lsfs.py)

Descriptions: Retrieve relevant files based on either the query\_text or keywords

Parameters:

* collection\_name (str): Name of the collection/agent
* query\_text (str): Text to search for
* k (int): Number of results to return (default: 3)
* keywords (str): Additional keywords for filtering (optional)

Returns:

* Successful retrieval (List): Matched Documents
* Failed retrieval: Empty List