convez.ai
MCP ServerDesenvolvimento WebIntermediário
nkieu-config

Workshop MCP & Agentes Multi-Agent com Google ADK

nkieu-config/ai-camp-agent-a2a-mcp-workshop

Aprenda agentes IA, MCP e A2A com Google ADK em 3 workshops práticos

Ver no GitHub
InicialPluginScore · de 0 a 100

Kit educacional completo para construir agentes IA agentic usando Google ADK, MCP (Model Context Protocol) e comunicação A2A (Agent-to-Agent). Inclui três workshops progressivos: criação de agentes simples, integração com MCP e sistemas multi-agent coordenados tipo escritório contábil.

Instalação

$npx convez-ai nkieu-config/ai-camp-agent-a2a-mcp-workshop

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Treinar desenvolvimento de agentes IA do zero
  • Implementar padrão MCP para comunicação estruturada entre agentes
  • Construir sistemas multi-agent com divisão de responsabilidades (CEO, analista, contador)
  • Prototipagem rápida de Research Buddy (assistente de pesquisa pessoal)

Veredito

Workshop bem estruturado com progressão didática clara: começa em agentes simples, evolui para MCP e termina em coordenação multi-agent. Usa Google ADK como base e Gemini grátis, tornando-o acessível; ideal para aprender padrões agentic modernos na prática.

README

A tradução para o português deste README ainda está na fila.

🎓 Workshop: Agentic AI + MCP & A2A

สร้าง "Research Buddy" — ผู้ช่วยทำวิจัยส่วนตัวของนักศึกษา ด้วย Google ADK

ช่วงWorkshopโฟลเดอร์
11:00 – 12:00Workshop 1: Agentic-AI — สร้าง agent ตัวแรก + เขียน tool เองworkshop1-agentic-ai/
14:15 – 15:15Workshop 2: MCP & A2A — ต่อ agent เข้ากับโลกภายนอก + คุยกับ agent ของเพื่อนworkshop2-mcp-a2a/
demo ปิดท้ายProject 3: AI Accounting Office — บริษัทจำลอง multi-agent (CEO + นักวิเคราะห์ + นักบัญชี) รวม MCP + A2Aproject3-accounting-office/

⚙️ Setup (ทำก่อนเริ่ม workshop — ใช้เวลา ~5 นาที)

ต้องมี Python 3.10 – 3.13 (เช็คด้วย python3 --version)

1) Clone และติดตั้ง

git clone https://github.com/Nightsky-na/workshop-TU-agent-mcp-a2a.git
cd workshop-TU-agent-mcp-a2a

python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

pip install -r requirements.txt

2) ขอ Gemini API key (ฟรี)

  1. ไปที่ https://aistudio.google.com/apikey
  2. ล็อกอินด้วย Google account → กด Create API key
  3. copy key เก็บไว้ (จะใช้ในขั้นถัดไป)

3) ใส่ API key

cp workshop1-agentic-ai/research_agent/.env.example workshop1-agentic-ai/research_agent/.env

แล้วเปิดไฟล์ .env ใส่ key ของตัวเอง:

GOOGLE_GENAI_USE_VERTEXAI=FALSE
GOOGLE_API_KEY=ใส่_key_ของคุณตรงนี้

4) ทดสอบว่าใช้งานได้

cd workshop1-agentic-ai
adk web

เปิด browser ไปที่ http://localhost:8000 — ถ้าเห็นหน้า chat UI แสดงว่าพร้อมแล้ว! 🎉

🗺️ ภาพรวมของทั้งวัน

Workshop 1 (เช้า)                    Workshop 2 (บ่าย)
┌─────────────────────┐             ┌────────────────────────────────┐
│  Research Agent      │             │  Host Agent                    │
│  ┌───────────────┐   │             │   ├── MCP ──▶ Paper Server     │
│  │ tools ของเรา   │   │   ───────▶  │   │          (อีก process)      │
│  │ search_arxiv  │   │             │   └── A2A ──▶ Summarizer Agent │
│  │ save_note     │   │             │              (อีกเครื่องก็ได้!)   │
│  └───────────────┘   │             └────────────────────────────────┘
└─────────────────────┘
        ทั้งหมดดูผ่าน adk web — เห็นทุก step ที่ agent คิดและเรียก tool

🆘 แก้ปัญหาที่เจอบ่อย

อาการวิธีแก้
adk: command not foundยังไม่ activate venv → source .venv/bin/activate
API key not validเช็คว่า copy key ครบ ไม่มีช่องว่างหน้า-หลัง
429 RESOURCE_EXHAUSTEDfree tier ติด rate limit → รอ 1 นาทีแล้วลองใหม่
Python 3.14 ใช้ไม่ได้ติดตั้ง Python 3.13: brew install python@3.13
Ver o original no GitHub

Bom para

Relacionados