site_name: LangGraph
site_description: Build language agents as graphs
site_url: https://langchain-ai.github.io/langgraph/
theme:
  name: material
  custom_dir: overrides
  logo: static/img/brand/wordmark.png
  favicon: static/img/brand/favicon.png
  features:
    - announce.dismiss
    - content.action.edit
    - content.action.view
    - content.code.annotate
    - content.code.copy
    - content.code.select
    - content.tabs.link
    - content.tooltips
    - header.autohide
    - navigation.expand
    - navigation.footer
    - navigation.indexes
    - navigation.instant
    - navigation.instant.prefetch
    - navigation.instant.progress
    - navigation.prune
    - navigation.sections
    - navigation.tabs
    - navigation.top
    - navigation.tracking
    - search.highlight
    - search.share
    - search.suggest
    - toc.follow
  palette:
  - scheme: default
    primary: white
    accent: gray
    toggle:
      icon: material/brightness-7
      name: Switch to dark mode
  - scheme: slate
    primary: grey
    accent: white
    toggle:
      icon: material/brightness-4
      name: Switch to light mode
  font:
    text: "Public Sans"
    code: "Roboto Mono"
plugins:
  - search:
      separator: '[\s\u200b\-_,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
  - autorefs
  - mkdocstrings:
      handlers:
        python:
          options:
            members_order: source 
            allow_inspection: true
            show_bases: true
  - mkdocs-jupyter:
      ignore_h1_titles: true
      execute: false
      include_source: True
      include_requirejs: true
  # TODO: Add minify plugin once it works alright with code block copying
  # - minify:
  #     minify_html: true
nav:
  - Home: 
      - 'index.md'
      - Quick Start: quick_start.ipynb
  - Concepts:
      - 'concepts.md'
  - "How-to Guides":
      - Basics:
          - State Management: how-tos/state-model.ipynb
          - Tool Integration: how-tos/sql_example.ipynb
          - Human-in-the-Loop: how-tos/human-in-the-loop.ipynb
      - Performance:  
          - Async Execution: how-tos/async.ipynb
          - Streaming Responses: how-tos/streaming-tokens.ipynb
      - Graph Structure:
          - Subgraphs: how-tos/subgraph.ipynb 
          - Branching: how-tos/branching.ipynb
      - Development:
          - Persistence: how-tos/persistence.ipynb
          - Visualization: how-tos/visualization.ipynb 
          - Time Travel: how-tos/time-travel.ipynb
          - Benchmarking: how-tos/swe-bench.ipynb
  - Tutorials:
      - Agent Executors:
          - Chat Agent (Function Calling):
              - Base: tutorials/chat_agent_executor_with_function_calling/base.ipynb
              - High-Level: tutorials/chat_agent_executor_with_function_calling/high-level.ipynb
              - High-Level Tools: tutorials/chat_agent_executor_with_function_calling/high-level-tools.ipynb
              - Modifications:
                  - Human-in-the-Loop: tutorials/chat_agent_executor_with_function_calling/human-in-the-loop.ipynb
                  - Force Tool First: tutorials/chat_agent_executor_with_function_calling/force-calling-a-tool-first.ipynb
                  - Respond in Format: tutorials/chat_agent_executor_with_function_calling/respond-in-format.ipynb 
                  - Dynamic Direct Return: tutorials/chat_agent_executor_with_function_calling/dynamically-returning-directly.ipynb
                  - Manage Agent Steps: tutorials/chat_agent_executor_with_function_calling/managing-agent-steps.ipynb
          - Langchain Agent:
              - Base: tutorials/agent_executor/base.ipynb
              - High-Level: tutorials/agent_executor/high-level.ipynb  
              - Modifications:
                  - Human-in-the-Loop: tutorials/agent_executor/human-in-the-loop.ipynb
                  - Force Tool First: tutorials/agent_executor/force-calling-a-tool-first.ipynb
                  - Manage Agent Steps: tutorials/agent_executor/managing-agent-steps.ipynb
      - Planning Agents:  
          - Plan-and-Execute: tutorials/plan-and-execute/plan-and-execute.ipynb
          - Reasoning w/o Observation: tutorials/rewoo/rewoo.ipynb 
          - LLMCompiler: tutorials/llm-compiler/LLMCompiler.ipynb
      - Reflection & Critique:
          - Basic Reflection: tutorials/reflection/reflection.ipynb
          - Reflexion: tutorials/reflexion/reflexion.ipynb
          - Language Agent Tree Search: tutorials/lats/lats.ipynb
      - Multi-Agent Systems:
          - Collaboration: tutorials/multi_agent/multi-agent-collaboration.ipynb  
          - Supervision: tutorials/multi_agent/agent_supervisor.ipynb
          - Hierarchical Teams: tutorials/multi_agent/hierarchical_agent_teams.ipynb
      - Research & QA:   
          - Web Research (STORM): tutorials/storm/storm.ipynb
          - Retrieval-Augmented Generation:
              - tutorials/rag/langgraph_adaptive_rag.ipynb
              - tutorials/rag/langgraph_adaptive_rag_cohere.ipynb
              - tutorials/rag/langgraph_adaptive_rag_local.ipynb
              - tutorials/rag/langgraph_agentic_rag.ipynb 
              - tutorials/rag/langgraph_crag.ipynb
              - tutorials/rag/langgraph_crag_local.ipynb
              - tutorials/rag/langgraph_self_rag.ipynb  
              - tutorials/rag/langgraph_self_rag_local.ipynb
      - Applications:
          - Chatbots: 
              - Customer Support: tutorials/chatbots/customer-support.ipynb
              - Info Gathering: tutorials/chatbots/information-gather-prompting.ipynb
          - Code Assistant: tutorials/code_assistant/langgraph_code_assistant.ipynb  
          - Web Navigation: tutorials/web-navigation/web_voyager.ipynb
      - Evaluation & Analysis:  
          - Chatbot Eval via Sim:
              - Agent-based: tutorials/chatbot-simulation-evaluation/agent-simulation-evaluation.ipynb
              - Dataset-based: tutorials/chatbot-simulation-evaluation/langsmith-agent-simulation-evaluation.ipynb  
          - Self-Discovering Agent: tutorials/self-discover/self-discover.ipynb
          - Swarm: tutorials/gptswarm/swarm.ipynb
  - Reference:
      - Graphs: reference/graphs.md
      - Checkpointing: reference/checkpoints.md
      - Prebuilt Components: reference/prebuilt_components.md
  

markdown_extensions:
  - abbr
  - admonition
  - pymdownx.details
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.emoji:
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
      emoji_index: !!python/name:material.extensions.emoji.twemoji
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      normalize_issue_symbols: true
      repo_url_shorthand: true
      user: langchain-ai 
      repo: langgraph
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.snippets:
      auto_append:
        - includes/mkdocs.md
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
      combine_header_slug: true
  - pymdownx.tasklist:
      custom_checkbox: true
extra_css:
  - css/mkdocstrings.css