add structured planning agent

docs/docs/module_guides/deploying/agents/modules.md

@@ -16,6 +16,7 @@ For more detailed guides on how to use specific tools, check out our [tools modu
 - [Multi Document Agents](../../../examples/agent/multi_document_agents.ipynb)
 - [Agent Builder](../../../examples/agent/agent_builder.ipynb)
 - [Parallel Function Calling](../../../examples/agent/openai_agent_parallel_function_calling.ipynb)
+- [Agent with Planning](../../../examples/agent/structured_planner.ipynb)
 
 ## [Beta] OpenAI Assistant Agent
 
@@ -49,4 +50,5 @@ For more detailed guides on how to use specific tools, check out our [tools modu
 
 - [Agent Runner](../../../examples/agent/agent_runner/agent_runner.ipynb)
 - [Agent Runner RAG](../../../examples/agent/agent_runner/agent_runner_rag.ipynb)
+- [Agent with Planning](../../../examples/agent/structured_planner.ipynb)
 - [Controllable Agent Runner](../../../examples/agent/agent_runner/agent_runner_rag_controllable.ipynb)

docs/docs/module_guides/deploying/agents/usage_pattern.md

@@ -108,6 +108,25 @@ query_engine_tools = [
 outer_agent = ReActAgent.from_tools(query_engine_tools, llm=llm, verbose=True)
 ```
 
+## Agent With Planning
+
+Breaking down an initial task into easier-to-digest sub-tasks is a powerful pattern.
+
+LlamaIndex provides an agent planning module that does just this:
+
+```python
+from llama_index.agent.openai import OpenAIAgentWorker
+from llama_index.core.agent import (
+    StructuredPlannerAgent,
+    FunctionCallingAgentWorker,
+)
+
+worker = FunctionCallingAgentWorker.from_tools(tools, llm=llm)
+agent = StructuredPlannerAgent(worker)
+```
+
+See more in the [complete guide](../../../examples/agent/structured_planner.ipynb)
+
 ## Lower-Level API
 
 The OpenAIAgent and ReActAgent are simple wrappers on top of an `AgentRunner` interacting with an `AgentWorker`.

docs/mkdocs.yml

@@ -85,6 +85,7 @@ nav:
           - ./examples/agent/coa_agent.ipynb
           - ./examples/agent/lats_agent.ipynb
           - ./examples/agent/llm_compiler.ipynb
+          - ./examples/agent/structured_planner.ipynb
       - Callbacks:
           - ./examples/callbacks/HoneyHiveLlamaIndexTracer.ipynb
           - ./examples/callbacks/PromptLayerHandler.ipynb

llama-index-core/llama_index/core/agent/__init__.py

@@ -7,13 +7,15 @@
 from llama_index.core.agent.react.step import ReActAgentWorker
 from llama_index.core.agent.react_multimodal.step import MultimodalReActAgentWorker
 from llama_index.core.agent.runner.base import AgentRunner
+from llama_index.core.agent.runner.planner import StructuredPlannerAgent
 from llama_index.core.agent.runner.parallel import ParallelAgentRunner
 from llama_index.core.agent.types import Task
 from llama_index.core.chat_engine.types import AgentChatResponse
 from llama_index.core.agent.function_calling.step import FunctionCallingAgentWorker
 
 __all__ = [
     "AgentRunner",
+    "StructuredPlannerAgent",
     "ParallelAgentRunner",
     "ReActAgentWorker",
     "ReActAgent",