Skip to content

README.md

Latest commit

 

History

History
104 lines (71 loc) · 2.48 KB

README.md

File metadata and controls

104 lines (71 loc) · 2.48 KB

Exemplos de Uso do Gmail CLI

Este diretório contém exemplos práticos de como usar o gmail-cli, especialmente voltados para Agentes de IA e automações.

📋 Índice de Exemplos

Python

Shell

🤖 Casos de Uso para Agentes de IA

1. Buscar Informações em Emails

Um agente pode buscar emails relevantes usando queries específicas:

gmail search "fatura cartão" --limit 5 --json

2. Extrair Conteúdo de Emails

Após obter IDs de emails, o agente pode ler o conteúdo:

gmail read <MESSAGE_ID> --json

3. Processar Dados Programaticamente

Todos os exemplos demonstram como:

  • Executar comandos usando subprocess (Python) ou pipes (Shell)
  • Parsear saída JSON
  • Tratar erros adequadamente
  • Processar resultados em lote

🚀 Como Usar os Exemplos

Pré-requisitos

  1. Instalar o Gmail CLI:

    pipx install git+https://github.com/ayrtonnotrya/gmail-cli.git

  2. Autenticar:

    gmail auth login --credentials /caminho/para/credentials.json

Executar Exemplos Python

cd examples
python agent_search.py
python agent_read.py
python llm_integration.py

Executar Exemplo Shell

cd examples
bash agent_workflow.sh

💡 Dicas para Agentes

  1. Sempre use a flag --json para obter saída estruturada
  2. Valide o JSON antes de processar (pode conter erros)
  3. Trate exceções de autenticação e rede
  4. Use queries específicas para reduzir resultados irrelevantes
  5. Limite os resultados com --limit para evitar sobrecarga

📚 Queries de Busca Úteis

# Emails não lidos
gmail search "is:unread" --json

# Emails de um remetente específico
gmail search "from:boss@company.com" --json

# Emails com anexos
gmail search "has:attachment" --json

# Emails recentes (últimos 7 dias)
gmail search "newer_than:7d" --json

# Combinação de critérios
gmail search "from:finance@company.com subject:invoice newer_than:30d" --json

🔗 Recursos Adicionais