update system design docs + assets

Author: alirezadir

01_foundations/README.md

@@ -41,12 +41,12 @@ Core concepts and foundational knowledge for building agentic AI systems.
 4. Study `llms/` for model integration
 5. Review `python/` for best practices -->
 
-## 📖 Resources
+<!-- ## 📖 Resources
 
 - [OpenAI Docs](https://platform.openai.com/docs)
 - [Hugging Face](https://huggingface.co/docs/transformers)
 - [LangChain](https://python.langchain.com/docs/get_started/introduction)
-- [CrewAI](https://docs.crewai.com)
+- [CrewAI](https://docs.crewai.com) -->
 
 ## 🔧 Tools & Resources
 

02_frameworks/4_llamaindex/README.md

@@ -1,13 +1,15 @@
+# LlamaIndex
+
+## Overview
+LlamaIndex is a framework for building AI agents that can use external data sources.
+
+<!-- ## Prerequisites
+
+## Usage
+<!--  -->
+## Code
 [ ] [TBD]
 
-### Code
-- Starter codes for building agents with LangGraph can be found in the [code](./code/README.md) including:
-    - `0_hello_world_graph.py`: Simple "Hello World" example for LangGraph.
-    - `0_langgraph_hello_world.py`: Another basic example for LangGraph.
-    - `1_build_basic_chatbot.py`: Basic chatbot implementation.
-    - `2_add_tools_chatbot.py`: Chatbot with tool integration.
-    - `3_add_memory_chatbot.py`: Chatbot with memory and context management.
-    - `advanced_workflow.py`: Advanced workflow example.
-    - `basic_workflow.py`: Basic workflow example.
-    - `complete_chatbot.py`: Full-featured chatbot implementation.
-    - `customer_support_bot.py`: Customer support bot example.
+## Docs
+- [LlamaIndex Agent Workflow](./docs/llama-index-agent-workflow.md)
+- [LlamaIndex Multi-Agent Workflow](./docs/llama-index-multi-agent-workflow.md)

02_frameworks/5_crewai/code/starter_project/src/starter_project/__init__.py

@@ -0,0 +1,3 @@
+"""
+CrewAI Starter Project Package
+""" 

02_frameworks/5_crewai/code/starter_project/src/starter_project/config/__init__.py

@@ -0,0 +1,3 @@
+"""
+Configuration files for the CrewAI project
+""" 

02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py

@@ -1,14 +1,14 @@
 #!/usr/bin/env python
 import os
 from dotenv import load_dotenv
-from starter_project.crew import ResearchAndWritingCrew
+from .crew import ResearchAndWritingCrew
 
 def main():
     """Run the research and writing crew."""
     # Load environment variables
     load_dotenv()
 
-    # Define the topic for research and writing
+    # Set the research topic
     topic = "Artificial Intelligence in Healthcare"
 
     # Create and run the crew

02_frameworks/5_crewai/code/starter_project/src/starter_project/tools/__init__.py

@@ -0,0 +1,3 @@
+"""
+Custom tools for the CrewAI project
+""" 

02_frameworks/5_crewai/code/starter_template.py

@@ -40,26 +40,29 @@
 research_task = Task(
     description="""Research the topic 'The Impact of Artificial Intelligence on Healthcare' 
     and gather key information about recent developments, benefits, and challenges.""",
-    agent=researcher
+    agent=researcher,
+    expected_output="A summary of recent developments, benefits, and challenges of AI in healthcare."
 )
 
 write_task = Task(
     description="""Write a comprehensive article about 'The Impact of Artificial Intelligence 
     on Healthcare' based on the research provided. Focus on making it engaging and informative.""",
-    agent=writer
+    agent=writer,
+    expected_output="A well-structured, engaging, and informative article about AI in healthcare."
 )
 
 review_task = Task(
     description="""Review the article about AI in healthcare. Check for accuracy, clarity, 
     and engagement. Provide suggestions for improvement.""",
-    agent=reviewer
+    agent=reviewer,
+    expected_output="A list of suggestions and corrections to improve the article's accuracy, clarity, and engagement."
 )
 
 # Create Crew
 crew = Crew(
     agents=[researcher, writer, reviewer],
     tasks=[research_task, write_task, review_task],
-    verbose=2,
+    verbose=True,
     process=Process.sequential
 )
 

03_system_design/RAGs/README.md

@@ -0,0 +1,28 @@
+## Multi-Modal RAGs
+![Multi-Modal RAGs](../../assets/RAGs/multimodal-RAG-o3-1.png)
+![Multi-Modal RAGs](../../assets/RAGs/multimodal-RAG-o1-1.png)
+![Multi-Modal RAGs](../../assets/RAGs/multimodal-RAG-o3-2.png)
+![Multi-Modal RAGs](../../assets/RAGs/multimodal-RAG-o3-3.png)
+### CRAGS
+![CRAGs](../../assets/RAGs/CRAG.png)
+### Self-RAGs
+![Self-RAGs](../../assets/RAGs/Self-RAG.png)
+### Agentic-RAGs
+![Agentic-RAGs](../../assets/RAGs/Agentic-RAG.png)
+![Agentic-RAGs](../../assets/RAGs/Agentic-RAG-2.png)
+![Agentic-RAGs](../../assets/RAGs/Agentic-RAG-3.png)
+### Adaptive-RAGs
+![Adaptive-RAGs](../../assets/RAGs/adaptive-RAG.png)
+### KG-RAGs
+![KG-RAGs](../../assets/RAGs/KG-RAG.png)
+
+
+## Examples 
+### Uber 
+- [Enhanced Agentic RAG at Uber (Uber Blog)](https://www.uber.com/blog/enhanced-agentic-rag/?utm_source=chatgpt.com)
+![Agentic RAG Architecture](../../assets/RAGs/uber-agentic-rag-architecture.png)
+    <!-- - [ ] summary (tba) -->
+
+
+
+

03_system_design/README.md

@@ -0,0 +1,109 @@
+# System Design for Agentic AI Systems
+
+This directory contains comprehensive resources for designing and architecting agentic AI systems. It covers everything from high-level architectural patterns to specific implementation cookbooks and evaluation methodologies.
+
+## Directory Structure
+
+### [Architectures](./architectures/)
+Comprehensive system architecture designs and blueprints for agentic AI systems.
+
+**Key Resources:**
+- [12-Step Agentic System Design Methodology](./architectures/ASD-12-step-v1.5.md) - Complete methodology for designing agentic systems
+- [Future Trends in Agentic Architecture](./architectures/agentic-arch-future.md) - Emerging trends and future directions
+- [Philosophical Agent System Design](./architectures/philoagent_system_architecture.md) - Philosophical foundations for agent design
+- [Modern AI Technology Stack](./architectures/AI-stack.md) - Overview of current AI technology stack
+- [AI-Native Application Design](./architectures/ai-native-1.md) - Principles for AI-native applications
+- [NVIDIA's Agentic AI Approach](./architectures/agentic-ai-nvidia.md) - NVIDIA's perspective on agentic AI
+
+### [Design Patterns](./design-patterns/)
+Design patterns and templates for building agentic systems with code examples and implementation details.
+
+**Key Resources:**
+- [Extended Design Patterns with Code](./design-patterns/AI-Agent-Design-Patterns-v1.3.md) - Design patterns with implementation examples
+- [Design Patterns with Code Examples](./design-patterns/patterns_w_codes.md) - Practical code examples for design patterns
+- [Reflexion Pattern Implementation](./design-patterns/Reflexion.md) - Implementation guide for the Reflexion pattern
+- [Design Patterns Overview](./design-patterns/README.md) - Overview of available design patterns
+
+### [Cookbooks](./cookbooks/)
+Practical implementation guides and tutorials for building agentic systems.
+
+**Key Resources:**
+- [A Practical Guide to AI Agents](./cookbooks/A-Practical-Guide-to-AI-Agents-updated.pdf) - Snowflake's comprehensive practical guide
+- [Building Effective Agents](./cookbooks/anthropic-build_effective_agents.md) - Anthropic's guide to building effective agents
+- [Compound AI Systems Implementation](./cookbooks/compund-ai-systems.md) - Implementation guide for compound AI systems
+
+### [Agentic AI](./agentic-ai/)
+Specialized resources focused on agentic AI system design.
+
+**Key Resources:**
+- [Agentic System Design Methodology](./agentic-ai/ASD-12-step-v1.5.md) - Specialized version of the 12-step methodology
+
+### [Layers](./layers/)
+Architectural layer designs and cognitive layer implementations.
+
+**Key Resources:**
+- [Cognitive Layer Architecture](./layers/_cognition_layer.md) - Design patterns for cognitive layers
+- [Reasoning and Planning Layer](./layers/_cognition_reason+plan.md) - Reasoning and planning layer design
+
+### [RAGs](./RAGs/)
+Retrieval-Augmented Generation systems and architectures.
+
+**Key Resources:**
+- [RAG Architectures Overview](./RAGs/README.md) - Comprehensive overview of RAG architectures
+- Multi-modal RAG implementations
+- CRAGs, Self-RAGs, Agentic-RAGs, Adaptive-RAGs, KG-RAGs
+- Real-world examples including Uber's Enhanced Agentic RAG
+
+### [Evals](./evals/)
+Evaluation methodologies and frameworks for agentic systems.
+
+**Key Resources:**
+- [Agent Evaluation Frameworks](./evals/agents_evals.md) - Comprehensive evaluation methodologies for agents
+
+### [Protocols](./protocols/)
+Communication protocols and standards for agentic systems.
+
+**Key Resources:**
+- [AI Communication Protocols](./protocols/protocols-AI.md) - Standards and protocols for AI communication
+
+### [Memory](./memory/)
+Memory systems and architectures for agentic AI.
+
+*Currently empty - placeholder for memory system designs*
+
+<!-- ## Getting Started
+
+1. **Start with Architectures**: Begin with the 12-step ASD methodology in [architectures/ASD-12-step-v1.5.md](./architectures/ASD-12-step-v1.5.md)
+2. **Explore Design Patterns**: Review the design patterns in [design-patterns/](./design-patterns/)
+3. **Study Real Examples**: Check out the cookbooks for practical implementation guides
+4. **Understand RAG Systems**: Explore the RAGs directory for retrieval-augmented generation patterns
+5. **Evaluate Your System**: Use the evaluation frameworks in the evals directory
+
+## Additional Resources
+
+See [SD_resources.md](./SD_resources.md) for curated external resources including:
+- Industry guides from Snowflake, Anthropic, and others
+- Big company implementations (AWS, Airbnb, Uber, NVIDIA)
+- Academic and research papers
+- Video tutorials and walkthroughs
+
+## Key Design Principles
+
+- **Modularity**: Design systems with clear separation of concerns
+- **Scalability**: Plan for growth and performance at scale
+- **Reliability**: Implement robust error handling and fallback mechanisms
+- **Security**: Consider safety and security from the ground up
+- **Evaluability**: Build systems that can be measured and improved
+
+## Contributing
+
+When adding new content:
+1. Follow the existing directory structure
+2. Include comprehensive documentation
+3. Provide code examples where applicable
+4. Update this README with new sections
+5. Ensure all files are properly referenced -->
+
+---
+
+*This directory serves as a comprehensive resource for designing, implementing, and evaluating agentic AI systems. Each subdirectory contains specialized knowledge and practical examples to help you build robust, scalable, and effective AI agent systems.* 

03_system_design/SD_resources.md

@@ -0,0 +1,11 @@
+- [A Practical Guide to AI Agents (Snowflake)](https://www.snowflake.com/thankyou/a-practical-guide-to-ai-agents/)
+- [Introduction to Agentic AI and Its Design Patterns (Lekha Bhan, Medium)](https://lekha-bhan88.medium.com/introduction-to-agentic-ai-and-its-design-patterns-af8b7b3ef738)
+- [Designing Agentic AI Systems, Part 1: Agent Architectures (Vectorize.io)](https://vectorize.io/designing-agentic-ai-systems-part-1-agent-architectures/)
+- [Design Considerations of Advanced Agentic AI for Real-World Applications (Indrajit Kar, Medium)](https://medium.com/@official.indrajit.kar/design-considerations-of-advanced-agentic-ai-for-real-world-applications-c5ef317ba1e1)
+
+## Agentic AI at Big Companies
+- [Agentic AI Design Patterns Introduction and walkthrough | AWS (YouTube)](https://www.youtube.com/watch?v=MrD9tCNpOvU&ab_channel=AmazonWebServices)
+- [Automation Platform v2: Improving Conversational AI at Airbnb (Airbnb Engineering, Medium)](https://medium.com/airbnb-engineering/automation-platform-v2-improving-conversational-ai-at-airbnb-d86c9386e0cb)
+- [Enhanced Agentic RAG at Uber (Uber Blog)](https://www.uber.com/blog/enhanced-agentic-rag/?utm_source=chatgpt.com)
+- [Intelligent Automation Platform: Empowering Conversational AI and Beyond at Airbnb (Airbnb Tech Blog)](https://airbnb.tech/ai-ml/intelligent-automation-platform-empowering-conversational-ai-and-beyond-at-airbnb/?utm_source=chatgpt.com)
+- [What is Agentic AI? (NVIDIA Blog)](https://blogs.nvidia.com/blog/what-is-agentic-ai/?utm_source=chatgpt.com)