# Ato 1: Conheça Seu Assistente de Pesquisa em IA 🤖 ![lab1](../../../../translated_images/pt-BR/lab1.1dd5210a7d114e2e.webp) ## O Desafio Você está lançando o "Future Bytes," seu novo podcast de tecnologia. O Episódio 1 é sobre os avanços mais recentes em IA, mas você tem 24 horas para: 1. Pesquisar o assunto 2. Encontrar fontes confiáveis 3. Escrever um roteiro envolvente 4. Fazer com que soe natural **Reviravolta**: Você não precisa fazer tudo sozinho. Você está prestes a construir seu primeiro assistente de IA que pode ajudar com tudo isso. Vamos chamá-lo de Alex — seu parceiro incansável de pesquisa que nunca precisa dormir. ## Por Que Modelos de Linguagem Pequenos? (Spoiler: Eles São Incríveis) Pense em Modelos de Linguagem Pequenos (SLMs) como sua IA pessoal que vive *no seu* computador. Nada de nuvem, mensalidades, ou compartilhamento suspeito de dados. **Por que os SLMs são 🔥:** - **🏠 Roda na Sua Máquina**: Laptop, desktop, até um Raspberry Pi poderoso - **💸 Sem Custos Contínuos**: Sem taxas de API comendo seu dinheiro - **🔒 Privacidade em Primeiro Lugar**: Seus dados nunca saem do seu dispositivo - **⚡ Super Rápido**: Sem atraso de internet, respostas instantâneas - **🪦 Leve**: 1B-10B parâmetros contra 100B+ dos grandões **SLMs populares**: Qwen 3, Phi-4, Gemma 3 (nós usamos Qwen para este workshop) ## Seu Kit de Ferramentas ### Ollama: Seu Gerenciador de Modelos de IA [Ollama](https://ollama.com/) é como a Steam para modelos de IA. Baixe, rode e gerencie modelos com comandos simples. **Por que é legal:** - Um comando para baixar e rodar qualquer modelo - Funciona no Mac, Windows, Linux - Usa automaticamente sua GPU se você tiver uma - Super eficiente em memória ### Microsoft Agent Framework: Onde a Magia Acontece [Microsoft Agent Framework](https://github.com/microsoft/agent-framework) é seu playground para construir agentes de IA que podem: - 💬 Conversar e lembrar do que falaram - 🛠️ Usar ferramentas personalizadas (como buscar na web ou checar o clima) - 🧠 Pensar em problemas complexos passo a passo - 🤝 Trabalhar com outros agentes em equipe - 🔌 Conectar a diferentes provedores de IA (OpenAI, Ollama, Azure) **Os Blocos de Construção:** - **Agentes**: Seus assistentes de IA com tarefas específicas - **Ferramentas**: Habilidades especiais que você dá a eles - **Memória**: Para que não esqueçam a conversa - **Raciocínio**: Ensinando-os a pensar, não só responder ## Seu Montagem de Treinamento: 4 Missões ### Missão 1: Crie Seu Primeiro Agente 📓 [Abra o Notebook](../code/01.BasicAgent/00.BasicAgent-agent.ipynb) **A Jornada**: Construa Alex, seu roteirista de podcast em IA. Alex precisa gerar diálogo entre dois apresentadores discutindo tópicos de tecnologia. **O Que Você Vai Aprender**: - Como acordar um agente de IA (é mais fácil que acordar na segunda) - Dar personalidade e instruções para ele - Fazer gerar roteiros reais de podcast - Entender o que ele responde para você **Condição de Vitória**: Alex cria um roteiro para o episódio piloto do "Future Bytes" sobre IA! 🎯 ### Missão 2: Dê Superpoderes ao Alex (Ferramentas!) 📓 [Abra o Notebook](../code/01.BasicAgent/01.BasicAgent-tools.ipynb) **A Jornada**: Alex é inteligente, mas não sabe o clima de hoje ou que horas são. Vamos consertar isso dando ferramentas! **O Que Você Vai Aprender**: - Criar funções Python personalizadas como “ferramentas” - Deixar Alex decidir *quando* usar qual ferramenta - Ver ele resolver problemas autonomamente - Combinar múltiplas ferramentas para tarefas complexas **Condição de Vitória**: Pergunte "Qual o clima em Tóquio?" e Alex descobre sozinho! ☁️ ### Missão 3: Ensine Alex a Pensar 📓 [Abra o Notebook](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb) **A Jornada**: Faça Alex mostrar seu raciocínio. Ao resolver problemas, você quer ver *como* ele pensa, não só a resposta. **O Que Você Vai Aprender**: - Ativar o “modo de raciocínio” (é como mostrar o cálculo na aula de matemática) - Ver o passo a passo do pensamento do Alex - Entender o prompting de cadeia de pensamentos - Debugar quando o Alex se confunde **Condição de Vitória**: Pergunte um problema de matemática difícil e veja Alex pensar! 🧠 ### Missão 4: Conecte Alex à Internet 📓 [Abra o Notebook](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb) **A Jornada**: O conhecimento do Alex tem uma data de corte. Vamos conectar ele à web para info em tempo real! **O Que Você Vai Aprender**: - Construir uma ferramenta personalizada de busca na web - Integrar APIs externas - Lidar com erros de rede com elegância - Obter informações além dos dados de treinamento do Alex **Condição de Vitória**: Pergunte sobre as notícias de tecnologia de hoje e obtenha resultados fresquinhos! 📰 ## Antes de Começar 🚀 **Equipamento Necessário**: - Python 3.10+ instalado - Ollama rodando (verifique com `ollama --version`) - VS Code com extensão Python - Pelo menos 8GB de RAM (16GB para uma experiência mais suave) ## Ordem das Missões Siga os notebooks na sequência para a história completa: 1. [00.BasicAgent-agent.ipynb](../code/01.BasicAgent/00.BasicAgent-agent.ipynb) — Conheça o Alex (seu primeiro agente) 2. [01.BasicAgent-tools.ipynb](../code/01.BasicAgent/01.BasicAgent-tools.ipynb) — Hora de turbinar! 3. [02.BasicAgent-reasoning.ipynb](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb) — Ensine Alex a pensar 4. [03.BasicAgent-websearch.ipynb](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb) — Acesso à internet desbloqueado! ## O Que Você Vai Dominar Depois do Ato 1, você poderá: - ✅ Rodar modelos de IA no seu próprio hardware (sem nuvem!) - ✅ Construir agentes com personalidades e habilidades customizadas - ✅ Dar ferramentas aos agentes para resolver problemas reais - ✅ Fazer os agentes mostrarem seu processo de raciocínio - ✅ Conectar agentes a fontes externas de dados - ✅ Debugar quando algo der errado ## Quando Algo Quebrar (E Como Consertar) 🔧 ### "Alex não carrega! Sem memória!" **A Solução**: Seu computador está com dificuldades. Tente fechar outros apps ou use um modelo menor. 8GB de RAM é o mínimo. ### "Alex está muuuito lento" **A Solução**: Ative aceleração GPU nas configurações do Ollama. Ou reduza o tamanho da janela de contexto. Modo demônio da velocidade ativado! 🏎️ ### "As ferramentas não estão funcionando!" **A Solução**: Verifique a assinatura das suas funções. Alex precisa de dicas de tipo claras para entender o que a ferramenta faz. Pense nisso como dar instruções claras. ## Links Úteis 🔗 - [Documentação do Agent Framework](https://github.com/microsoft/agent-framework) — Guias oficiais e exemplos - [Biblioteca de Modelos Ollama](https://ollama.com/library) — Explore todos os modelos disponíveis - [Modelo Qwen](https://ollama.com/library/qwen3) — Conheça o cérebro da sua IA - [Exemplos de Código](https://github.com/microsoft/agent-framework/tree/main/python/samples) — Pegue ideias daqui ## Próximo: Ato 2 🎬 Você já tem um agente. Mas e se tivesse um *time* de agentes trabalhando juntos? No Ato 2, você vai construir sua equipe completa de produção de podcast: - **Agente Pesquisador**: Encontra as melhores fontes - **Agente Escritor**: Cria o roteiro perfeito - **Editor (Você!)**: Aprova ou pede mudanças Vamos orquestrar um pouco de mágica de IA! → [Ato 2: Reuna Sua Equipe de Produção](02.AIAgentOrchestrationAndWorkflows.md) --- **Travou?** Faça perguntas durante o workshop. Estamos todos aprendendo juntos! 🙌 --- **Aviso Legal**: Este documento foi traduzido utilizando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.