cr

docs/docs/how_to_guides.md

@@ -8,33 +8,165 @@ However, these guides will help you quickly accomplish common tasks.
 
 - How to return structured data from an LLM
 - How to use an LLM to call tools
-- How to stream
+- [How to stream](/docs/docs/expression_language/streaming)
 - How to see what is going on inside your LLM application
 - How to test your LLM application
 - How to deploy your LLM application
 
-### LCEL
+### Tool Usage
 
-- [How to chain runnables](/docs/expression_language/primitives/sequence)
-- [How to run two runnables in parallel](/docs/expression_language/primitives/parallel/)
-- [How to attach runtime arguments to a runnable](/docs/expression_language/primitives/binding/)
-- 
+- [How to use tools in a chain](/docs/docs/use_cases/tool_use/quickstart/)
+- [How to use agents to use tools](/docs/docs/use_cases/tool_use/agents)
+- [How to use tools without function calling](/docs/docs/use_cases/tool_use/prompting)
+- [How to let the LLM choose between multiple tools](/docs/docs/use_cases/tool_use/multiple_tools)
+- [How to add a human in the loop to tool usage](/docs/docs/use_cases/tool_use/human_in_the_loop)
+- [How to do parallel tool use](/docs/docs/use_cases/tool_use/parallel)
+- [How to handle errors when calling tools](/docs/docs/use_cases/tool_use/tool_error_handling)
+
+## LangChain Expression Language (LCEL)
+
+- [How to chain runnables](/docs/docs/expression_language/primitives/sequence)
+- [How to run two runnables in parallel](/docs/docs/expression_language/primitives/parallel/)
+- [How to attach runtime arguments to a runnable](/docs/docs/expression_language/primitives/binding/)
+- [How to run custom functions](/docs/docs/expression_language/primitives/functions)
+- [How to pass through arguments from one step to the next](/docs/docs/expression_language/primitives/passthrough)
+- [How to add values to state](/docs/docs/expression_language/primitives/assign)
+- [How to configure runtime chain internals](/docs/docs/expression_language/primitives/configure)
+- [How to add message history](/docs/docs/expression_language/how_to/message_history)
+- [How to do routing](/docs/docs/expression_language/how_to/routing)
+- [How to inspect your runnables](/docs/docs/expression_language/how_to/inspect)
+- [How to use `@chain` decorator to create a runnable](/docs/docs/expression_language/how_to/decorator)
+- [How to manage prompt size](/docs/docs/expression_language/cookbook/prompt_size)
+- [How to string together multiple chains](/docs/docs/expression_language/cookbook/multiple_chains)
 
 ## Components
 
 ### Prompts
-- [How to use example selectors](/docs/modules/model_io/prompts/example_selectors/)
-- [How to use few shot examples in chat models](/docs/modules/model_io/prompts/few_shot_examples_chat/)
+- [How to use example selectors](/docs/docs/modules/model_io/prompts/example_selectors/)
+- [How to use few shot examples](/docs/docs/modules/model_io/prompts/few_shot_examples)
+- [How to use few shot examples in chat models](/docs/docs/modules/model_io/prompts/few_shot_examples_chat/)
+- [How to partial prompt templates](/docs/docs/modules/model_io/prompts/partial)
+- [How to compose two prompts together](/docs/docs/modules/model_io/prompts/composition)
+
+### Chat Models
+- [How to function/tool calling](/docs/docs/modules/model_io/chat/function_calling)
+- [How to get models to return structured output](/docs/docs/modules/model_io/chat/structured_output)
+- [How to cache model responses](/docs/docs/modules/model_io/chat/chat_model_caching)
+- [How to get log probabilities](/docs/docs/modules/model_io/chat/logprobs)
+- [How to create a custom chat model class](/docs/docs/modules/model_io/chat/custom_chat_model)
+- [How to stream a response back](/docs/docs/modules/model_io/chat/streaming)
+- [How to track token usage](/docs/docs/modules/model_io/chat/token_usage_tracking)
+
+### LLMs
+- [How to cache model responses](/docs/docs/modules/model_io/llms/llm_caching)
+- [How to create a custom LLM class](/docs/docs/modules/model_io/llms/custom_llm)
+- [How to stream a response back](/docs/docs/modules/model_io/llms/streaming_llm)
+- [How to track token usage](/docs/docs/modules/model_io/llms/token_usage_tracking)
+
+### Output Parsers
+- [How to use output parsers to parse an LLM response into structured format](/docs/docs/modules/model_io/output_parsers/quick_start)
+- [How to pase JSON output](/docs/docs/modules/model_io/output_parsers/types/json)
+- [How to pase XML output](/docs/docs/modules/model_io/output_parsers/types/xml)
+- [How to pase YAML output](/docs/docs/modules/model_io/output_parsers/types/yaml)
+- [How to retry when output parsing errors occur](/docs/docs/modules/model_io/output_parsers/types/retry)
+- [How to try to fix errors in output parsing](/docs/docs/modules/model_io/output_parsers/types/output_fixing)
+- [How to write a custom output parser class](/docs/docs/modules/model_io/output_parsers/custom)
+
+### Document Loaders
+- [How to load CSV data](/docs/docs/modules/data_connection/document_loaders/csv)
+- [How to load data from a directory](/docs/docs/modules/data_connection/document_loaders/file_directory)
+- [How to load HTML data](/docs/docs/modules/data_connection/document_loaders/html)
+- [How to load JSON data](/docs/docs/modules/data_connection/document_loaders/json)
+- [How to load Markdown data](/docs/docs/modules/data_connection/document_loaders/markdown)
+- [How to load Microsoft Office data](/docs/docs/modules/data_connection/document_loaders/office_file)
+- [How to load PDF files](/docs/docs/modules/data_connection/document_loaders/pdf)
+- [How to write a custom document loader](/docs/docs/modules/data_connection/document_loaders/custom)
+
+### Text Splitter
+- [How to recursively split text](/docs/docs/modules/data_connection/document_transformers/recursive_text_splitter)
+- [How to split by HTML headers](/docs/docs/modules/data_connection/document_transformers/HTML_header_metadata)
+- [How to split by HTML sections](/docs/docs/modules/data_connection/document_transformers/HTML_section_aware_splitter)
+- [How to split by character](/docs/docs/modules/data_connection/document_transformers/character_text_splitter)
+- [How to split code](/docs/docs/modules/data_connection/document_transformers/code_splitter)
+- [How to split Markdown by headers](/docs/docs/modules/data_connection/document_transformers/markdown_header_metadata)
+- [How to recursively split JSON](/docs/docs/modules/data_connection/document_transformers/recursive_json_splitter)
+- [How to split text into semantic chunks](/docs/docs/modules/data_connection/document_transformers/semantic-chunker)
+- [How to split by tokens](/docs/docs/modules/data_connection/document_transformers/split_by_token)
+
+### Embedding Models
+- [How to embed text data](/docs/docs/modules/data_connection/text_embedding)
+- [How to cache embedding results](/docs/docs/modules/data_connection/text_embedding/caching_embeddings)
+
+### Vector Stores
+- [How to use a vector store to retrieve data](/docs/docs/modules/data_connection/vectorstores)
+
+### Retrievers
+- [How use a vector store to retrieve data](/docs/docs/modules/data_connection/retrievers/vectorstore)
+- [How to generate multiple queries to retrieve data for](/docs/docs/modules/data_connection/retrievers/MultiQueryRetriever)
+- [How to use contextual compression to compress the data retrieved](/docs/docs/modules/data_connection/retrievers/contextual_compression)
+- [How to write a custom retriever class](/docs/docs/modules/data_connection/retrievers/custom_retriever)
+- [How to combine the results from multiple retrievers](/docs/docs/modules/data_connection/retrievers/ensemble)
+- [How to reorder retrieved results to put most relevant documents not in the middle](/docs/docs/modules/data_connection/retrievers/long_context_reorder)
+- [How to generate multiple embeddings per document](/docs/docs/modules/data_connection/retrievers/multi_vector)
+- [How to retrieve the whole document for a chunk](/docs/docs/modules/data_connection/retrievers/parent_document_retriever)
+- [How to generate metadata filters](/docs/docs/modules/data_connection/retrievers/self_query)
+- [How to create a time-weighted retriever](/docs/docs/modules/data_connection/retrievers/time_weighted_vectorstore)
+
+### Indexing
+- [How to reindex data to keep your vectorstore in-sync with the underlying data source](/docs/docs/modules/data_connection/indexing)
+
+### Tools
+- [How to use LangChain tools](/docs/docs/modules/tools)
+- [How to use LangChain toolkits](/docs/docs/modules/tools/toolkits)
+- [How to define a custom tool](/docs/docs/modules/tools/custom_tools)
+- [How to convert LangChain tools to OpenAI functions](/docs/docs/modules/tools/tools_as_openai_functions)
+
+### Agents
+- [How to create a custom agent](/docs/docs/modules/agents/how_to/custom_agent)
+- [How to stream responses from an agent](/docs/docs/modules/agents/how_to/streaming)
+- [How to run an agent as an iterator](/docs/docs/modules/agents/how_to/agent_iter)
+- [How to return structured output from an agent](/docs/docs/modules/agents/how_to/agent_structured)
+- [How to handle parsing errors in an agent](/docs/docs/modules/agents/how_to/handle_parsing_errors)
+- [How to access intermediate steps](/docs/docs/modules/agents/how_to/intermediate_steps)
+- [How to cap the maximum number of iterations](/docs/docs/modules/agents/how_to/max_iterations)
+- [How to set a time limit for agents](/docs/docs/modules/agents/how_to/max_time_limit)
 
 ## Use Cases
 
 ### Q&A with RAG
-- [How to add chat history](/docs/use_cases/question_answering/chat_history/)
-- [How to stream](/docs/use_cases/question_answering/streaming/)
-- [How to return sources](/docs/use_cases/question_answering/sources/)
-- [How to return citations](/docs/use_cases/question_answering/citations/)
+- [How to add chat history](/docs/docs/use_cases/question_answering/chat_history/)
+- [How to stream](/docs/docs/use_cases/question_answering/streaming/)
+- [How to return sources](/docs/docs/use_cases/question_answering/sources/)
+- [How to return citations](/docs/docs/use_cases/question_answering/citations/)
+- [How to do per-user retrieval](/docs/docs/use_cases/question_answering/per_user/)
 
 
 ### Extraction
-- [How to use reference examples](/docs/use_cases/extraction/how_to/examples/)
-- [How to handle long text](/docs/use_cases/extraction/how_to/handle_long_text/)
+- [How to use reference examples](/docs/docs/use_cases/extraction/how_to/examples/)
+- [How to handle long text](/docs/docs/use_cases/extraction/how_to/handle_long_text/)
+- [How to do extraction without using function calling](/docs/docs/use_cases/extraction/how_to/parse)
+
+### Chatbots
+- [How to manage memory](/docs/docs/use_cases/chatbots/memory_management)
+- [How to do retrieval](/docs/docs/use_cases/chatbots/retrieval)
+- [How to use tools](/docs/docs/use_cases/chatbots/tool_usage)
+
+### Query Analysis
+- [How to add examples to the prompt](/docs/docs/use_cases/query_analysis/how_to/few_shot)
+- [How to handle cases where no queries are generated](/docs/docs/use_cases/query_analysis/how_to/no_queries)
+- [How to handle multiple queries](/docs/docs/use_cases/query_analysis/how_to/multiple_queries)
+- [How to handle multiple retrievers](/docs/docs/use_cases/query_analysis/how_to/multiple_retrievers)
+- [How to construct filters](/docs/docs/use_cases/query_analysis/how_to/constructing-filters)
+- [How to deal with high cardinality categorical variables](/docs/docs/use_cases/query_analysis/how_to/high_cardinality)
+
+### Q&A over SQL + CSV
+- [How to use prompting to improve results](/docs/docs/use_cases/sql/prompting)
+- [How to do query validation](/docs/docs/use_cases/sql/query_checking)
+- [How to deal with large databases](/docs/docs/use_cases/sql/large_db)
+- [How to deal with CSV files](/docs/docs/use_cases/sql/csv)
+
+### Q&A over Graph Databases
+- [How to map values to a database](/docs/docs/use_cases/graph/mapping)
+- [How to add a semantic layer over the database](/docs/docs/use_cases/graph/semantic)
+- [How to improve results with prompting](/docs/docs/use_cases/graph/prompting)
+- [How to construct knowledge graphs](/docs/docs/use_cases/graph/constructing)

docs/docs/tutorials.md

@@ -4,18 +4,34 @@ New to LangChain?
 Or to LLM app development in general? 
 Well, you came to the right place: read this material to quickly get up and running.
 
-[Build a Retrieval Augmented Generation (RAG) Application](/docs/use_cases/question_answering/quickstart/)
+[Build a Retrieval Augmented Generation (RAG) Application](/docs/docs/use_cases/question_answering/quickstart/)
 
-[Build an Extraction Service](/docs/use_cases/extraction/quickstart/)
+[Build an Extraction Service](/docs/docs/use_cases/extraction/quickstart/)
 
-[Build a ChatBot](/docs/use_cases/chatbots/quickstart/)
+[Build a ChatBot](/docs/docs/use_cases/chatbots/quickstart/)
 
-[Build an Agent](/docs/modules/agents/quick_start/)
+[Build an Agent](/docs/docs/modules/agents/quick_start/)
 
-[Build a Natural Language Layer over a Function](/docs/use_cases/tool_use/quickstart/)
+[Build a Query Analysis System](/docs/docs/use_cases/query_analysis/quickstart/)
 
-[Build a Query Analysis System](/docs/use_cases/query_analysis/quickstart/)
+[Build a Question/Answering Chain over SQL/CSV data](/docs/docs/use_cases/sql/quickstart/)
 
-[Build a Question/Answering System over SQL/CSV data](/docs/use_cases/sql/quickstart/)
+[Build a Question/Answering Agent over SQL/CSV data](/docs/docs/use_cases/sql/agents/)
+
+[Build a RAG Agent](/docs/docs/use_cases/question_answering/conversational_retrieval_agents)
+
+[Build a local RAG application](/docs/docs/use_cases/question_answering/local_retrieval_qa)
+
+[Build an application to Question Answering over a Graph Database](/docs/docs/use_cases/graph/quickstart)
+
+[Build a coding helper](/docs/docs/use_cases/code_understanding)
+
+[Generate synthetic data](/docs/docs/use_cases/data_generation)
+
+[Classify text into labels](/docs/docs/use_cases/tagging)
+
+[Summarize text](/docs/docs/use_cases/summarization)
+
+[Scrape webpages using LLMs](/docs/docs/use_cases/web_scraping)
 
 For a longer list of tutorials, see our [cookbook section](https://github.com/langchain-ai/langchain/tree/master/cookbook).