Agente inteligente de automação de fluxo de trabalho integrado ao Trello, desenvolvido com Google ADK e Gemini 2.5 Flash.
Projeto desenvolvido como atividade prática do Bootcamp "DIO — Do Prompt ao Agente".
O Trello Process Bot é um agente de IA conversacional que permite gerenciar tarefas no Trello através de linguagem natural. O usuário descreve o que precisa fazer e o agente interpreta, organiza, prioriza e executa as ações diretamente no board do Trello sem necessidade de acessar a interface manualmente.
- 📌 Adicionar tarefas — Cria cards no Trello com nome, descrição e data de vencimento
- 📋 Listar tarefas — Consulta tarefas por status: todas, a fazer, em andamento ou concluídas
- 🔄 Mover tarefas — Altera o status de um card entre as listas do board
- 🕐 Contexto temporal — Obtém a data e hora atual para orientar as interações
- 🧠 Priorização inteligente — Classifica tarefas por prioridade: baixa, média, alta ou urgente
trello-process-bot/
├── deskmanager/
│ ├── __init__.py
│ └── agent.py # Agente principal e ferramentas
├── .env # Variáveis de ambiente (não versionar)
├── .gitignore
├── requirements.txt
└── README.md
- Python 3.10+
- Conta no Trello com um board chamado
Bot - Conta no Google AI Studio para obter a
GOOGLE_API_KEY - Board no Trello com as listas:
A FAZER,EM ANDAMENTO,EM REVISÃO,CONCLUÍDO,REFINAMENTO
git clone https://github.com/seu-usuario/trello-process-bot.git
cd trello-process-botpip install -r requirements.txtCrie um arquivo .env na raiz do projeto:
GOOGLE_GENAI_USE_VERTEXAI=0
GOOGLE_API_KEY=sua_google_api_key
TRELLO_API_KEY=sua_trello_api_key
TRELLO_API_SECRET=seu_trello_api_secret
TRELLO_TOKEN=seu_trello_token
⚠️ Nunca suba o arquivo.envpara o repositório.
- API Key e Secret: Acesse https://trello.com/power-ups/admin, crie um Power-Up e copie a API Key.
- Token: Acesse a URL abaixo substituindo
SUA_API_KEY:
https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&key=SUA_API_KEY
adk webAcesse http://localhost:8000 no navegador e comece a conversar com o agente.
Usuário: Olá!
Agente: Olá! Hoje é 17/04/2025. Quais tarefas você precisa organizar hoje?
Usuário: Preciso criar uma tarefa para revisar o relatório até sexta-feira.
Agente: Entendido! Vou cadastrar a tarefa "Revisar relatório" na lista A FAZER
com vencimento em 18/04 (corrigindo o D-1 do Trello). Confirma?
Usuário: Quais tarefas estão em andamento?
Agente: [lista as tarefas da lista EM ANDAMENTO]
Usuário: Muda a tarefa "Revisar relatório" para concluído.
Agente: Tarefa movida de 'A FAZER' para 'CONCLUÍDO' com sucesso!
| Tecnologia | Descrição |
|---|---|
| Google ADK | Framework para criação de agentes de IA |
| Gemini 2.5 Flash | Modelo de linguagem utilizado pelo agente |
| py-trello | Biblioteca Python para integração com a API do Trello |
| python-dotenv | Gerenciamento de variáveis de ambiente |
| Variável | Descrição |
|---|---|
GOOGLE_GENAI_USE_VERTEXAI |
Define se usa Vertex AI (0 = não, usa AI Studio) |
GOOGLE_API_KEY |
Chave da API do Google AI Studio |
TRELLO_API_KEY |
Chave da API do Trello (32 caracteres) |
TRELLO_API_SECRET |
Secret da API do Trello |
TRELLO_TOKEN |
Token de acesso do Trello (64 caracteres) |
- O board no Trello deve se chamar exatamente
Bot - As listas do board devem conter os nomes:
A FAZER,EM ANDAMENTO,EM REVISÃO,CONCLUÍDO,REFINAMENTO - O Trello possui um bug de datas (D-1): ao cadastrar um card, a data exibida fica um dia antes do esperado. O agente já está configurado para corrigir isso automaticamente, somando 1 dia à data informada.
Este projeto foi desenvolvido para fins educacionais no Bootcamp DIO — Do Prompt ao Agente.
Desenvolvido por José Hermes como atividade prática do Bootcamp DIO — Do Prompt ao Agente.