Merge branch 'fix/update-agentic-readmes-with-arch-diagrams' into 'develop'

Adding architecture diagrams to relevant READMEs

See merge request genaiic-reusable-assets/engagement-artifacts/genaiic-idp-accelerator!286

Author: rstrahan

docs/agent-analysis.md

@@ -37,15 +37,18 @@ https://github.com/user-attachments/assets/e2dea2c5-5eb1-42f6-9af5-469afd2135a7
 
 ## Architecture
 
+The architecture of the Agent Analysis feature is shown below. The Web UI and AppSync API components are the same as used by the rest of the IDP system (with new AppSync endpoints added). Note the inclusion of Amazon Athena and the AgentCore Code Interpreter is specific to the Analytics Agent, but the Agent Request Handler and Processor lambdas along with jobs table are used for all agents, including [MCP agents](./custom-MCP-agent.md).
+
+![Architecture Diagram](../images/IDP-AnalyticsAgent.drawio.png)
+
 ### Multi-Agent System
 
 The Agent Analysis feature uses a multi-agent architecture with:
 
 1. **Orchestrator Agent**: Routes queries to appropriate specialized agents based on query content and agent capabilities
 2. **Analytics Agent**: Handles data analysis, SQL generation, and visualization creation
-3. **Dummy Agent**: Provides simple calculations and development testing capabilities
-4. **External MCP Agents**: Custom agents connected via Model Context Protocol servers
-5. **Extensible Framework**: Easy addition of new specialized agents for specific use cases
+3. **External MCP Agents**: Custom agents connected via Model Context Protocol servers
+
 
 ### Agent Workflow
 

docs/custom-MCP-agent.md

@@ -20,23 +20,9 @@ The External MCP Agent allows you to:
 - **Real-time Integration**: Tools are available immediately through the IDP web interface
 
 ## Architecture
+An example architecture demonstrating the authentication flow and connections between the MCP Client (running in the IDP application) and an external MCP Server (deployed outside of the IDP application) can be seen below. The `get_client_address` and `send_verification_email` APIs drawn are just for demonstration purposes.
 
-```
-┌─────────────────────┐    ┌──────────────────────┐    ┌─────────────────────┐
-│   IDP Solution      │    │   Your AWS Account   │    │   Your MCP Server   │
-│                     │    │                      │    │                     │
-│ ┌─────────────────┐ │    │ ┌──────────────────┐ │    │ ┌─────────────────┐ │
-│ │ External MCP    │ │    │ │ AWS Cognito      │ │    │ │ Custom Tools    │ │
-│ │ Agent           │◄┼────┼─┤ User Pool        │◄┼────┼─┤ - Calculator    │ │
-│ │                 │ │    │ │                  │ │    │ │ - Weather API   │ │
-│ └─────────────────┘ │    │ └──────────────────┘ │    │ │ - Database      │ │
-│                     │    │                      │    │ │ - Custom Logic  │ │
-│ ┌─────────────────┐ │    │                      │    │ └─────────────────┘ │
-│ │ AWS Secrets     │ │    │                      │    │                     │
-│ │ Manager         │ │    │                      │    │                     │
-│ └─────────────────┘ │    │                      │    │                     │
-└─────────────────────┘    └──────────────────────┘    └─────────────────────┘
-```
+![Architecture Diagram](../images/IDP-external-mcp-example.drawio.png)
 
 ## Prerequisites