# asucicrepo/admissions-ai-agent architecture

> Architecture diagram of the GitHub repository asucicrepo/admissions-ai-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asucicrepo/admissions-ai-agent
- Repository: https://github.com/asucicrepo/admissions-ai-agent

## Overview

This repository implements Nemo, an AI admissions counselor presented through a university landing page and chat. Prospective students can ask questions, receive multilingual knowledge-base answers, and be connected with admissions staff; separate lead-capture and follow-up paths support CRM updates and WhatsApp messaging. The README documents these product integrations, while sampled frontend references identify the chat interface and agent client. Backend tool internals were not sampled, so their links reflect documented capabilities rather than verified call sites.

Main entry points: [`Backend/admissions-ai-agent/AgentCore/nemo_agent.py`](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/nemo_agent.py) (Nemo agent), [`Frontend/components/nemo/nemo-chat-interface.tsx`](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/nemo/nemo-chat-interface.tsx) (Nemo chat), [`Frontend/components/mapua-landing-page.tsx`](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/mapua-landing-page.tsx) (Admissions site), [`Frontend/lib/agent-client.ts`](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/lib/agent-client.ts) (Agent client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_landing["Admissions site"]
  node_chat["Nemo chat"]
  node_agentclient["Agent client<br/>[agent-client.ts]"]
  node_inquiry["Inquiry form<br/>[inquiry-form.tsx]"]
end

subgraph group_agent["Agent capabilities"]
  node_proxy["Streaming proxy<br/>[index.js]"]
  node_nemo["Nemo agent<br/>[nemo_agent.py]"]
  node_retrieval["Knowledge retrieval<br/>[retrieve_tool.py]"]
  node_translation["Translation<br/>[translate_tool.py]"]
  node_session["Session management<br/>[session_utils.py]"]
end

subgraph group_admissions["Admissions operations"]
  node_handoff["Advisor handoff"]
  node_salesforcetool["CRM tools"]
  node_formlambda["Lead submission<br/>[form_submission.py]"]
  node_whatsapp["WhatsApp tool"]
  node_whatsapplambda["WhatsApp sender"]
end

subgraph group_integrations["External services"]
  node_knowledge[("University knowledge base")]
  node_salesforce[("Salesforce CRM")]
  node_twilio["Twilio WhatsApp"]
end

node_student(("Prospective student"))
node_advisor(("Admissions advisor"))

node_student -->|"visits"| node_landing
node_landing -->|"offers chat"| node_chat
node_student -->|"asks questions"| node_chat
node_chat -->|"sends messages"| node_agentclient
node_agentclient -.->|"streams requests"| node_proxy
node_proxy -.->|"routes to agent"| node_nemo
node_nemo -->|"retrieves answers"| node_retrieval
node_retrieval -->|"queries"| node_knowledge
node_nemo -->|"translates conversation"| node_translation
node_nemo -.->|"manages session"| node_session
node_nemo -->|"initiates handoff"| node_handoff
node_handoff -->|"connects student"| node_advisor
node_nemo -->|"updates lead"| node_salesforcetool
node_salesforcetool -->|"writes records"| node_salesforce
node_student -->|"submits inquiry"| node_inquiry
node_inquiry -.->|"submits lead"| node_formlambda
node_formlambda -->|"creates lead"| node_salesforce
node_nemo -->|"triggers follow-up"| node_whatsapp
node_whatsapp -->|"sends message"| node_twilio
node_whatsapplambda -->|"sends message"| node_twilio

click node_landing "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/mapua-landing-page.tsx"
click node_chat "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/nemo/nemo-chat-interface.tsx"
click node_agentclient "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/lib/agent-client.ts"
click node_proxy "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/lambda/agent-proxy/index.js"
click node_nemo "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/nemo_agent.py"
click node_retrieval "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/retrieve_tool.py"
click node_translation "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/translate_tool.py"
click node_session "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/session_utils.py"
click node_handoff "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/advisor_handoff_tool.py"
click node_salesforcetool "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/salesforce_tools.py"
click node_inquiry "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/inquiry-form.tsx"
click node_formlambda "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/lambda/form_submission.py"
click node_whatsapp "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/whatsapp_twilio_tool.py"
click node_whatsapplambda "https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/lambda/send_whatsapp_twilio.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_landing,node_chat,node_agentclient,node_inquiry toneBlue
class node_proxy,node_nemo,node_retrieval,node_translation,node_session toneAmber
class node_handoff,node_salesforcetool,node_formlambda,node_whatsapp,node_whatsapplambda toneMint
class node_knowledge,node_salesforce,node_twilio toneRose
class node_student,node_advisor toneIndigo
```

## Components

### Student experience

- [Admissions site](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/mapua-landing-page.tsx): `Frontend/components/mapua-landing-page.tsx`
- [Nemo chat](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/nemo/nemo-chat-interface.tsx): `Frontend/components/nemo/nemo-chat-interface.tsx`
- [Agent client](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/lib/agent-client.ts): `Frontend/lib/agent-client.ts`
- [Inquiry form](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Frontend/components/inquiry-form.tsx): `Frontend/components/inquiry-form.tsx`

### Agent capabilities

- [Streaming proxy](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/lambda/agent-proxy/index.js): `Backend/admissions-ai-agent/lambda/agent-proxy/index.js`
- [Nemo agent](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/nemo_agent.py): `Backend/admissions-ai-agent/AgentCore/nemo_agent.py`
- [Knowledge retrieval](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/retrieve_tool.py): `Backend/admissions-ai-agent/AgentCore/tools/retrieve_tool.py`
- [Translation](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/translate_tool.py): `Backend/admissions-ai-agent/AgentCore/tools/translate_tool.py`
- [Session management](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/session_utils.py): `Backend/admissions-ai-agent/AgentCore/tools/session_utils.py`

### Admissions operations

- [Advisor handoff](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/advisor_handoff_tool.py): `Backend/admissions-ai-agent/AgentCore/tools/advisor_handoff_tool.py`
- [CRM tools](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/salesforce_tools.py): `Backend/admissions-ai-agent/AgentCore/tools/salesforce_tools.py`
- [Lead submission](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/lambda/form_submission.py): `Backend/admissions-ai-agent/lambda/form_submission.py`
- [WhatsApp tool](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/AgentCore/tools/whatsapp_twilio_tool.py): `Backend/admissions-ai-agent/AgentCore/tools/whatsapp_twilio_tool.py`
- [WhatsApp sender](https://github.com/asucicrepo/admissions-ai-agent/blob/main/Backend/admissions-ai-agent/lambda/send_whatsapp_twilio.py): `Backend/admissions-ai-agent/lambda/send_whatsapp_twilio.py`

### External services

- **University knowledge base**
- **Salesforce CRM**
- **Twilio WhatsApp**

### Other components

- **Prospective student**
- **Admissions advisor**

## Connections

- Prospective student → Admissions site: visits (evidence: `README.md`)
- Admissions site → Nemo chat: offers chat (evidence: `README.md`)
- Prospective student → Nemo chat: asks questions (evidence: `README.md`)
- Nemo chat → Agent client: sends messages (evidence: `Frontend/components/nemo/nemo-chat-interface.tsx`)
- Agent client → Streaming proxy: streams requests (evidence: `README.md`)
- Streaming proxy → Nemo agent: routes to agent (evidence: `README.md`)
- Nemo agent → Knowledge retrieval: retrieves answers (evidence: `README.md`)
- Knowledge retrieval → University knowledge base: queries (evidence: `README.md`)
- Nemo agent → Translation: translates conversation (evidence: `README.md`)
- Nemo agent → Session management: manages session
- Nemo agent → Advisor handoff: initiates handoff (evidence: `README.md`)
- Advisor handoff → Admissions advisor: connects student (evidence: `README.md`)
- Nemo agent → CRM tools: updates lead (evidence: `README.md`)
- CRM tools → Salesforce CRM: writes records (evidence: `README.md`)
- Prospective student → Inquiry form: submits inquiry (evidence: `README.md`)
- Inquiry form → Lead submission: submits lead (evidence: `README.md`)
- Lead submission → Salesforce CRM: creates lead (evidence: `README.md`)
- Nemo agent → WhatsApp tool: triggers follow-up (evidence: `README.md`)
- WhatsApp tool → Twilio WhatsApp: sends message (evidence: `README.md`)
- WhatsApp sender → Twilio WhatsApp: sends message (evidence: `README.md`)
