​

Integrating Text File Content into Your Chat Agent

Enhancing your chat agent with the inclusion of plain text (.txt) files broadens its knowledge base, enabling it to draw upon a diverse range of textual content. The txt_chat method facilitates the seamless integration of text files into your chat agent, making this wealth of information accessible for enhancing conversation quality and relevance.

​

Function Overview

The txt_chat function is designed to ingest content from text files into your chat agent, employing a variety of parameters to ensure this process is both efficient and effective.

​

Parameters

• input_dir (Optional[str]): Directory path containing text files to be added. If specified, the function will search this directory for eligible files.
• input_files (Optional[List]): A list of paths to specific text files to be added. When provided, input_dir is bypassed.
• exclude_hidden (bool): If True, hidden files or those starting with a dot (.) within input_dir are excluded.
• filename_as_id (bool): If True, the filename is used as the unique identifier for each text document.
• recursive (bool): If True, the function will also search subdirectories within input_dir for text files.
• required_exts (Optional[List[str]]): Specifies the file extensions to include. Defaults to text file extensions.
• system_prompt (str): An optional prompt to guide the system in processing text file content.
• query_wrapper_prompt (str): An optional prompt that can improve the relevance of search queries by providing context related to the text content.
• embed_model (Union[str, EmbedType]): The embedding model used for extracting and embedding text from the files. Defaults to a general-purpose model.
• llm_params (dict): Configuration parameters for integrating Large Language Models to enhance content comprehension and query processing.
• vector_store_params (dict): Configuration for vector storage, specifying how and where extracted content embeddings are stored.
• service_context_params (dict): Additional parameters to customize the service context for the text file content.
• chat_engine_params (dict): Customization parameters for the chat engine, influencing how the chat agent utilizes text file content in conversations.
• retriever_params (dict): Configuration for the document retriever component, determining how text file content is indexed and retrieved in response to user queries.

​

Example Usage

​

Adding Text Files from a Directory

chat_agent.txt_chat(
    input_dir="/path/to/text/files",
    recursive=True
)

This snippet configures the chat agent to ingest text files from the specified directory and its subdirectories.

​

Adding Specific Text Files

chat_agent.txt_chat(
    input_files=["/path/to/file1.txt", "/path/to/file2.txt"],
)

Here, specific text files are directly added to the chat agent, allowing it to leverage their content in conversations.