为什么值得关注

它提供了实用的、本地化的 Notebook，解决了免费的配额限制、模型选择等实际问题，同时涵盖了单代理工具/记忆以及多代理编排模式。

适合谁使用

葡萄牙语 AI 初学者
不熟悉 Google ADK 的开发者
工作坊或 meetup 参会者
对代理式 AI 感兴趣的爱好者

典型使用场景

创建具有工具调用和对话记忆的自定义代理
构建多代理流水线（顺序、循环、并行、路由）
使用免费 API Key 实验 Gemini 模型
动手学习代理编排模式

项目优势

逐步引导的 Colab Notebook，无需本地安装
包含模型发现单元和明确的速率限制处理说明
涵盖基础代理构造和高级多代理工作流
Notebook 使用葡萄牙语本地化，包含真实世界示例

使用前须知

仅支持 Google Gemini/ADK 生态系统
Notebook 为葡萄牙语，限制非葡萄牙语使用者
依赖 Google API Key 和免费层的配额限制

README 快速开始

🤖 Agent Foundry: Engenharia e Construção de Agentes com Google ADK

Material da palestra e workshop apresentados no Build With AI Curitiba — 12/07/2026 🎉

Se você chegou aqui pelo evento: seja bem-vindo(a)! Este repositório foi montado para você conseguir reproduzir tudo em casa, do zero, mesmo que nunca tenha criado um agente de IA antes.

📦 O que tem neste repositório

Arquivo	O que é
`ADK_BuildWithAICuritiba_Ahirton.pptx`	Os slides da palestra (Agentes de IA, casos de uso, MCP, A2A e ADK)
`ADK_Agent_Foundry_1.ipynb`	Notebook 1 — Tools & Memory: seu primeiro agente, ferramentas customizadas e memória de conversa
`ADK_Agent_Foundry_2.ipynb`	Notebook 2 — MultiAgents: orquestração de times de agentes (Sequential, Loop, Parallel e Router)

▶️ Abrir direto no Google Colab (não precisa instalar nada na sua máquina):

Notebook 1 — Tools & Memory
Notebook 2 — MultiAgents

🚀 Comece por aqui (passo a passo para iniciantes)

O material do workshop são os dois notebooks deste repositório — feitos em PT-BR, com exemplos ambientados em Curitiba e já preparados para os modelos Gemini atuais e para os limites do tier gratuito. Siga na ordem: Notebook 1 e depois Notebook 2.

1. Gere sua API key do Google AI Studio

Acesse https://aistudio.google.com/app/apikey com sua conta Google.
Clique em "Create API key" e copie a chave (os formatos atuais começam com AIza... ou AQ...).

2. Abra o Notebook 1 no Colab

Use o botão "Open in Colab" lá em cima — não precisa instalar nada na sua máquina. Depois salve uma cópia sua: Arquivo → Salvar uma cópia no Drive.

3. Guarde a chave no Colab

No menu lateral esquerdo do Colab, clique no ícone de chave (🔑 Secrets).
Crie um secret chamado GOOGLE_API_KEY, cole sua chave e habilite o acesso do notebook.

4. Rode as células na ordem

Execute célula por célula (Shift+Enter). Uma das primeiras células lista todos os modelos Gemini disponíveis para a sua chave e os recursos de cada um — vale a pena olhar antes de seguir. Terminou o Notebook 1? Siga para o Notebook

项目描述

Workshop Agent Foundry (Build With AI Curitiba 2026): notebooks em PT-BR para construir agentes e times multiagentes com Google ADK + Gemini, com exemplos ambientados em Curitiba. Inclui os slides da palestra.

build-with-ai-curitiba-2026