Curso Intensivo do OpenAI Agents SDK

Uma série de tutoriais abrangentes para aprender o OpenAI Agents SDK desde os conceitos básicos até os avançados. Este curso intensivo foi concebido para te levar do zero ao herói na construção de agentes de IA com o OpenAI Agents SDK.

📚 O que é o OpenAI Agents SDK?

O OpenAI Agents SDK é um poderoso framework para desenvolver e implementar agentes de IA. Ele oferece:

Principais Características:

• Orquestração de Agentes: Criar e gerir agentes de IA inteligentes
• Integração de Ferramentas: Expandir agentes com ferramentas personalizadas e integradas
• Saídas Estruturadas: Respostas seguras em termos de tipo utilizando modelos Pydantic
• Fluxos de Trabalho Multi-Agente: Coordenar múltiplos agentes com transferências
• Execução em Tempo Real: Métodos de execução síncrona, assíncrona e em streaming
• Integração de Voz: Capacidades de voz estática, em streaming e em tempo real
• Gestão de Sessões: Memória e histórico de conversação automáticos
• Pronto para Produção: Rastreio, guardrails e monitorização integrados

🎯 Caminho de Aprendizagem

Este curso intensivo cobre os conceitos essenciais do OpenAI Agents SDK através de tutoriais práticos:

📚 Tutoriais

🌱 Camada de Fundação

1. 1_starter_agent - O teu primeiro agente OpenAI

• Criação e configuração básica de agentes
• Compreensão dos diferentes métodos de execução
• Processamento de texto simples e respostas

2. 2_structured_output_agent - Respostas seguras em termos de tipo

• Agente de Suporte - Converter queixas em tickets estruturados
• Agente de Avaliação de Produto - Extrair dados estruturados de avaliações
• Modelos Pydantic e validação

🔧 Camada de Capacidades Centrais

3. 3_tool_using_agent - Ferramentas e funções do agente

• Ferramentas de função personalizadas com @function_tool
• Ferramentas integradas (WebSearch, CodeInterpreter, FileSearch)
• Integração de ferramentas e padrões de execução

4. 4_running_agents - Domínio da execução e funcionamento

• O ciclo do agente: Chamadas LLM, execução de ferramentas, transferências
• Métodos de execução síncrona, assíncrona e em streaming
• Eventos de streaming avançados e tratamento de exceções
• Configuração de execução e gestão de conversas

5. 5_context_management - Gestão de estado e contexto

• Passagem de contexto entre execuções
• Persistência e gestão de estado
• Controlo do fluxo de conversação

🧠 Camada de Funcionalidades Avançadas

6. 6_guardrails_validation - Segurança e validação

• Guardrails de entrada para validação do utilizador
• Guardrails de saída para filtragem de respostas
• Validação de regras de negócio personalizadas

7. 7_sessions - Gestão de sessões e memória

• Histórico de conversação automático com SQLiteSession
• Operações de memória e correções de conversação
• Gestão e organização de múltiplas sessões

🤝 Camada Multi-Agente

8. 8_handoffs_delegation - Transferências e delegação de agentes

• Delegação de tarefas de agente para agente
• Sistemas de triagem e roteamento inteligente
• Configuração avançada de transferências com callbacks

9. 9_multi_agent_orchestration - Fluxos de trabalho complexos

• Execução paralela de agentes com asyncio.gather()
• Agentes como padrões de orquestração de ferramentas
• Coordenação de fluxos de trabalho em múltiplas etapas

🔍 Camada de Produção

10. 10_tracing_observability - Monitorização e depuração

• Rastreio integrado e visualização de execução
• Rastreios e spans personalizados para fluxos de trabalho complexos
• Monitorização e otimização de desempenho

🎙️ Voz e Funcionalidades Avançadas

11. 11_voice - Agentes de voz e conversação em tempo real

• Processamento de voz estática (interação em turnos)
• Processamento de voz em streaming (conversação em tempo real)
• Agentes de voz em tempo real (latência ultra-baixa com WebSocket)
• Conversão de fala em texto, texto em fala e pipelines de voz

🛠️ Pré-requisitos

Antes de começares este curso intensivo, assegura-te de que tens:

• Python 3.8+ instalado (Python 3.9+ necessário para funcionalidades de voz)
• Chave da API OpenAI da OpenAI Platform
• Compreensão básica de Python e APIs
• Familiaridade com conceitos async/await (útil mas não obrigatório)
• Para tutoriais de voz: Microfone e colunas/fones

📖 Como Usar Este Curso

Cada tutorial segue uma estrutura consistente:

• README.md: Explicação do conceito e objetivos de aprendizagem
• Ficheiros Python: Contém as implementações e exemplos do agente
• Interfaces interativas: Aplicações web Streamlit para testes práticos
• Submódulos: Exemplos organizados para diferentes conceitos
• requirements.txt: Dependências para o tutorial
• env.example: Modelo de variável de ambiente

Abordagem de Aprendizagem:

1. Lê o README para entender o conceito
2. Examina o código para ver a implementação
3. Executa os exemplos para ver os agentes em ação
4. Experimenta modificando o código
5. Usa interfaces interativas para testes práticos
6. Experimenta funcionalidades de voz (tutorial 11) com o teu microfone
7. Avança para o próximo tutorial quando estiveres pronto

🎯 Características do Tutorial

Cada tutorial inclui:

• ✅ Explicação clara do conceito
• ✅ Exemplos de código mínimos e funcionais
• ✅ Casos de uso do mundo real
• ✅ Instruções passo a passo
• ✅ Interfaces web interativas
• ✅ Melhores práticas e dicas

🚀 Início Rápido

1. Clona o repositório e navega até este diretório
2. Escolhe um tutorial da lista acima
3. Segue as instruções do README para esse tutorial
4. Instala as dependências: pip install -r requirements.txt
5. Configura o ambiente: Copia env.example para .env e adiciona a tua chave de API
6. Executa os exemplos e começa a aprender!

🔧 Configuração do Ambiente

Cada tutorial requer uma chave de API da OpenAI. Cria um ficheiro .env em cada diretório de tutorial:

OPENAI_API_KEY=sk-your_openai_key_here

Get your API key from: https://platform.openai.com/api-keys

💡 Dicas de Aprendizagem

• Começa Sequencialmente: Segue os tutoriais na ordem para uma melhor experiência de aprendizagem
• Experimenta Livremente: Modifica o código e vê o que acontece
• Usa Interfaces Web: Aplicações interativas tornam a aprendizagem mais envolvente
• Lê as Mensagens de Erro: Muitas vezes contêm orientações úteis
• Junta-te à Comunidade: Interage com outros aprendizes e partilha experiências

🚨 Problemas Comuns

Problemas com a Chave da API

• Certifica-te de que o teu ficheiro .env está no diretório do tutorial
• Verifica se a tua chave da API é válida e tem créditos suficientes
• Verifica se há erros de digitação no nome da variável de ambiente

Erros de Importação

• Assegura-te de que instalaste os requisitos: pip install -r requirements.txt
• Verifica se estás a usar Python 3.8 ou superior
• Tenta criar um ambiente virtual se tiveres conflitos

Limitação de Taxa

• A OpenAI tem limites de taxa com base no teu plano
• Se atingires os limites, espera um momento antes de tentares novamente
• Considera atualizar o teu plano OpenAI para limites mais altos

📚 Recursos Adicionais

• Documentação do OpenAI Agents SDK
• Plataforma OpenAI
• Documentação do Pydantic
• Documentação do Streamlit

🤝 Contribuições

Sente-te à vontade para contribuir com melhorias, correções de bugs ou tutoriais adicionais. Cada tutorial deve:

• Ser autónomo e executável
• Incluir documentação clara
• Seguir a estrutura estabelecida
• Usar código mínimo e compreensível

📊 Acompanhamento de Progresso

Acompanha o teu progresso através do curso:

• [ ] Tutorial 1: Criação de agente básico ✨
• [ ] Tutorial 2: Saídas estruturadas com Pydantic
• [ ] Tutorial 3: Integração de ferramentas e funções personalizadas
• [ ] Tutorial 4: Domínio dos métodos de execução
• [ ] Tutorial 5: Gestão de contexto e estado
• [ ] Tutorial 6: Guardrails e validação
• [ ] Tutorial 7: Gestão de sessões e memória
• [ ] Tutorial 8: Transferências de agentes e delegação
• [ ] Tutorial 9: Orquestração multi-agente
• [ ] Tutorial 10: Rastreio e observabilidade
• [ ] Tutorial 11: Agentes de voz e conversa em tempo real 🎯

Boa aprendizagem! 🚀