typescript-agent-a2a

```markdown # 🤖 TypeScript Agent-to-Agent (A2A) System > An enterprise-level Agent microservice collaboration system example built on **Node.js + TypeScript**. ## 📖 Project Introduction This project demonstrates how to build a complete **A2A (Agent-to-Agent)** architecture using **TypeScript** full-stack technology without relying on the Python ecosystem. The system includes a user-facing gateway Agent and an internal expert Agent, supporting deployment on Azure Container Apps. ## 🏗️ System Architecture * **Agent A (Gateway)**: External gateway, hosting the web frontend and responsible for routing and distribution. * **Agent B (Worker)**: Internal microservice, simulating LLM (Large Language Model) thinking and processing. * **Protocol**: A lightweight communication protocol based on JSON Slot. ```mermaid graph LR User -->|HTTP| AgentA[Agent A (Gateway)] AgentA -->|REST/Slot| AgentB[Agent B (Internal)] AgentB -.->|Think| LLM ``` ## ✨ Core Features - [x] **Pure TypeScript Implementation**: Eliminates Python dependencies, unifying the tech stack. - [x] **Microservice Architecture**: Separation of responsibilities, with A handling routing and B managing business logic. - [x] **Dockerized**: Includes multi-stage build optimizations, resulting in a small image size. - [x] **Azure Ready**: Designed specifically for the network topology of Azure Container Apps (ACA). ## 🚀 Quick Start ### 1. Install Dependencies ```bash npm install ``` ### 2. Start Development Environment You need to open two terminal windows: ```bash # Terminal 1: Start internal Agent B (Port 3001) npm run start:b # Terminal 2: Start gateway Agent A (Port 3000) npm run start:a ``` ### 3. Experience Open your browser and visit `http://localhost:3000` to interact with the Agent cluster through a visual interface. ## 📦 Deployment (Docker) ```bash # Build images docker build -t agent-a:v1 -f Dockerfile.agent-a . docker build -t agent-b:v1 -f Dockerfile.agent-b . # Run containers docker run -p 3000:3000 agent-a:v1 ``` --- *Created for the modern AI Engineer.* ```