docs: add how-to section on tool calling (#1051)

docs/_scripts/copy_notebooks.py

@@ -38,6 +38,7 @@ _MANUAL = {
         "subgraph.ipynb",
         "force-calling-a-tool-first.ipynb",
         "pass-run-time-values-to-tools.ipynb",
+        "tool-calling.ipynb",
         "tool-calling-errors.ipynb",
         "dynamic-returning-direct.ipynb",
         "managing-agent-steps.ipynb",

docs/docs/how-tos/index.md

@@ -54,12 +54,17 @@ These guides show how to use different streaming modes.
 - [How to stream events from within a tool without LangChain models](streaming-events-from-within-tools-without-langchain.ipynb)
 - [How to stream events from the final node](streaming-from-final-node.ipynb)
 
+## Tool calling
+
+- [How to call tools using ToolNode](tool-calling.ipynb)
+- [How to handle tool calling errors](tool-calling-errors.ipynb)
+
 ## Other
+
 - [How to run graph asynchronously](async.ipynb)
 - [How to visualize your graph](visualization.ipynb)
 - [How to add runtime configuration to your graph](configuration.ipynb)
 - [How to pass runtime values to tools](pass-run-time-values-to-tools.ipynb)
-- [How to handle tool calling errors](tool-calling-errors.ipynb)
 - [How to use a Pydantic model as your state](state-model.ipynb)
 - [How to use a context object in state](state-context-key.ipynb)
 

docs/mkdocs.yml

@@ -152,12 +152,14 @@ nav:
           - Stream events from within tools: how-tos/streaming-events-from-within-tools.ipynb
           - Stream events from within tools without LangChain models: how-tos/streaming-events-from-within-tools-without-langchain.ipynb
           - Stream events from the final node: how-tos/streaming-from-final-node.ipynb
+      - Tool calling:
+          - Call tools using ToolNode: how-tos/tool-calling.ipynb
+          - Handle tool calling errors: how-tos/tool-calling-errors.ipynb
       - Other:
           - Run graph asynchronously: how-tos/async.ipynb
           - Visualize your graph: how-tos/visualization.ipynb
           - Add runtime configuration: how-tos/configuration.ipynb
           - Pass runtime values to tools: how-tos/pass-run-time-values-to-tools.ipynb
-          - Handle tool calling errors: how-tos/tool-calling-errors.ipynb
           - Use Pydantic model as state: how-tos/state-model.ipynb
           - Use a context object in state: how-tos/state-context-key.ipynb
       - Prebuilt ReAct Agent: