# keremp/insecure-ai-agents architecture

> Architecture diagram of the GitHub repository keremp/insecure-ai-agents, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-02-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/keremp/insecure-ai-agents
- Repository: https://github.com/keremp/insecure-ai-agents

## Overview

##### Data Layer
- SQLite Database (Patient Data)
- Tables/fields:
- Patient Records (name, age, gender, diagnosis_date, etc.)
- External Data Source (Johns Hopkins Clinical Trials)

##### AI Agent Architecture
- Supervisor Agent
- Worker Agent 1 (Database Access)
- Worker Agent 2 (Web Scraping)

##### Integration Points
- Web Scraping Interface
- Database Interface
- Inter-agent Communication Channels

- [External Clinical Trials Data] → [Web Scraping Agent]
- ↓
- [Patient Database] → [Database Agent] → [Supervisor Agent] → [Results/Recommendations]

##### Security Boundaries (Critical for this project)
- Potential vulnerability points:
- Prompt injection entry points
- Agent communication boundaries
- Data access controls

##### Data Flow Representation
- Raw data flow (patient data, trial data)
- Agent communications
- Final recommendations flow

- Red: Security-critical components
- Blue: Data storage components
- Green: Processing agents
- Yellow: External data sources

Special Considerations:

##### Security Layer
- A security overlay showing:
- Prompt injection vulnerabilities
- Excessive agency risks
- Data access controls

##### Guardrails Implementation
- Where security measures are implemented
- Differences between the three versions:
- Basic version
- With guardrails
- With Haize

##### Process Flow
1. Database initialization
2. Trial data collection
3. Patient-trial matching
4. Recommendation generation

- Agent Boundaries
- Data Flow Types
- Security Zones
- Vulnerability Points
- Control Mechanisms

Key Architectural Patterns to Highlight:
##### Data Pipeline Pattern

- The high-level multi-agent architecture
- The security vulnerability points
- The data flow between components
- The security measures in different versions

Remember to include notes about:
- LangSmith integration points
- Security review findings
- Different versions of the implementation

This system design should emphasize both the functional architecture and the security considerations, as this is a demonstration project for AI security vulnerabilities.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Data_Layer
        DB[(Patient Database)]
        ExtData[External Clinical Trials Data]:::external
    end

    subgraph AI_Agents
        direction TB
        subgraph Worker_Agents
            WA1[Database Agent]:::agent
            WA2[Web Scraping Agent]:::agent
        end
        SA[Supervisor Agent]:::agent
    end

    subgraph Security_Zones
        direction TB
        PI[Prompt Injection Vulnerabilities]:::security
        EAR[Excessive Agency Risks]:::security
        DAC[Data Access Controls]:::security
    end

    subgraph Implementations
        direction TB
        Basic["Basic Implementation"]:::impl
        Guardrails["Implementation with Guardrails"]:::impl
        Haize["Implementation with Haize"]:::impl
    end

    subgraph Results
        REC[Results/Recommendations]:::output
    end

    %% Data Flow Connections
    ExtData --> WA2
    DB --> WA1
    WA1 --> SA
    WA2 --> SA
    SA --> REC

    %% Security Connections
    PI -.-> WA1
    PI -.-> WA2
    EAR -.-> SA
    DAC -.-> DB

    %% Implementation Connections
    Basic --> SA
    Guardrails --> SA
    Haize --> SA

    %% Styling
    classDef agent fill:#90EE90,stroke:#333,stroke-width:2px
    classDef security fill:#FFB6C6,stroke:#333,stroke-width:2px
    classDef external fill:#FFE4B5,stroke:#333,stroke-width:2px
    classDef impl fill:#ADD8E6,stroke:#333,stroke-width:2px
    classDef output fill:#E6E6FA,stroke:#333,stroke-width:2px

    %% Click Events
    click DB "https://github.com/KeremP/insecure-ai-agents/blob/main/create_patient_db.py"
    click Basic "https://github.com/KeremP/insecure-ai-agents/blob/main/get_patients_fit_for_als_trials.py"
    click Guardrails "https://github.com/KeremP/insecure-ai-agents/blob/main/get_patients_fit_for_als_trials_with_guardrails.py"
    click Haize "https://github.com/KeremP/insecure-ai-agents/blob/main/get_patients_fit_for_als_trials_with_haize.py"

    %% Legend
    subgraph Legend
        L1[AI Agent]:::agent
        L2[Security Control]:::security
        L3[External Source]:::external
        L4[Implementation Version]:::impl
        L5[Output]:::output
    end
```
