"""
Pattern 24.02: Graceful Degradation
Reduced functionality on failure
"""
from typing import TypedDict
from langgraph.graph import StateGraph, END
from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage
class GracefulDegradationState(TypedDict):
"""State for Graceful Degradation pattern."""
input: str
output: str
metadata: dict
def agent_function(state: GracefulDegradationState) -> GracefulDegradationState:
"""Graceful Degradation agent implementation."""
llm = ChatOpenAI()
prompt = f"Process using Graceful Degradation: {state['input']}"
response = llm.invoke([HumanMessage(content=prompt)])
state["output"] = str(response.content)
state["metadata"] = {"pattern": "Graceful Degradation", "status": "completed"}
return state
def create_graceful_degradation():
"""Create Graceful Degradation workflow."""
workflow = StateGraph(GracefulDegradationState)
workflow.add_node("agent", agent_function)
workflow.set_entry_point("agent")
workflow.add_edge("agent", END)
return workflow.compile()
if __name__ == "__main__":
workflow = create_graceful_degradation()
result = workflow.invoke({"input": "Test Graceful Degradation", "output": "", "metadata": {}})
print(f"\n=== Graceful Degradation Pattern ===\nOutput: {result['output'][:200]}...")
Agentic Orchestration Pattern: Graceful Degradation
02 Graceful Degradation Pattern – Detailed Documentation
Overview
File: 24_resilience/02_graceful_degradation.py
Pattern Category: 24 Resilience
Implementation: LangGraph/CrewAI
Pattern Description
Pattern 24.02: Graceful Degradation Reduced functionality on failure
Code Structure
Imports
from typing import TypedDict
from langgraph.graph import StateGraph, END
from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage
Purpose of imports:
– TypedDict: For type-safe state definitions
– StateGraph: LangGraph’s graph-based workflow orchestration
– ChatOpenAI: OpenAI LLM integration
– HumanMessage: LangChain message formatting
State Definition
class GracefulDegradationState(TypedDict):
"""State for Graceful Degradation pattern."""
input: str
output: str
metadata: dict
def agent_function(state: GracefulDegradationState) -> GracefulDegradationState:
GracefulDegradationState: State for Graceful Degradation pattern.
State Fields:
– input: Stores input
– output: Stores output
– metadata: Stores metadata
– def agent_function(state: Stores def agent function(state
– prompt = f"Process using Graceful Degradation: Stores prompt = f”Process using Graceful Degradation
– state["metadata"] = {"pattern": Stores state[“metadata”] = {“pattern”
Functions
agent_function()
Line: 18
Arguments: state
Graceful Degradation agent implementation.
def agent_function(state: GracefulDegradationState) -> GracefulDegradationState:
"""Graceful Degradation agent implementation."""
llm = ChatOpenAI()
prompt = f"Process using Graceful Degradation: {state['input']}"
response = llm.invoke([HumanMessage(content=prompt)])
state["output"] = str(response.content)
state["metadata"] = {"pattern": "Graceful Degradation", "status": "completed"}
return state
def create_graceful_degradation():
create_graceful_degradation()
Line: 28
Arguments: “
Create Graceful Degradation workflow.
def create_graceful_degradation():
"""Create Graceful Degradation workflow."""
workflow = StateGraph(GracefulDegradationState)
workflow.add_node("agent", agent_function)
workflow.set_entry_point("agent")
workflow.add_edge("agent", END)
return workflow.compile()
if __name__ == "__main__":
Line-by-Line Explanation
Line 5: Import statement
from typing import TypedDict
Imports TypedDict for creating type-safe state dictionaries.
Line 6: Import statement
from langgraph.graph import StateGraph, END
Imports StateGraph – the core LangGraph class for building workflows.
Line 7: Import statement
from langchain_openai import ChatOpenAI
Imports ChatOpenAI for LLM interactions.
Line 8: Import statement
from langchain_core.messages import HumanMessage
Imports HumanMessage for formatting prompts to the LLM.
Line 11: Class definition
class GracefulDegradationState(TypedDict):
Defines the state structure using TypedDict for type safety.
Line 12: Module docstring
"""State for Graceful Degradation pattern."""
Describes the pattern and its purpose.
Line 18: Function agent_function definition
def agent_function(state: GracefulDegradationState) -> GracefulDegradationState:
Defines the agent_function function that processes the workflow state.
Line 19: Module docstring
"""Graceful Degradation agent implementation."""
Describes the pattern and its purpose.
Line 28: Function create_graceful_degradation definition
def create_graceful_degradation():
Defines the create_graceful_degradation function that processes the workflow state.
Line 29: Module docstring
"""Create Graceful Degradation workflow."""
Describes the pattern and its purpose.
Usage Example
if __name__ == "__main__":
workflow = create_graceful_degradation()
result = workflow.invoke({"input": "Test Graceful Degradation", "output": "", "metadata": {}})
print(f"\n=== Graceful Degradation Pattern ===\nOutput: {result['output'][:200]}...")
Key Concepts
- State Management: Uses TypedDict to maintain workflow state
- Graph-Based Flow: LangGraph orchestrates execution flow
- Agent Functions: Each node processes and updates state
- LLM Integration: Uses ChatOpenAI for intelligent processing
Pattern Benefits
- ✅ Type-safe state management
- ✅ Clear workflow visualization
- ✅ Modular and reusable components
- ✅ Easy to test and debug
- ✅ Scalable architecture
Related Patterns
- See other patterns in the same category
- Explore combination possibilities
- Check the main documentation for pattern relationships