👮🧠 Agente Cidadão Inteligente - ACI ChatBot

Este projeto implementa um sistema de chatbot inteligente para fornecer informações sobre serviços sociais e outros recursos em uma determinada localização, passada pelo usuário durante a inicialização da conversa, utilizando agentes de IA e a API do Google Gemini.

💭 Descrição

O projeto ACI (Agente Cidadão Inteligente) tem como objetivo facilitar o acesso dos cidadãos de uma determinada região, a informações sobre serviços sociais e recursos relacionados com áreas como: Educação, Saúde e Segurança. Ele utiliza um chatbot alimentado pela API do Google Gemini para responder a perguntas dos usuários de forma inteligente e fornecer detalhes relevantes sobre os serviços disponíveis. De forma sucinta, confiável e amigável, atingindo todos e qualquer público-alvo.

O sistema é projetado para:

Entender as perguntas dos usuários em linguagem natural -- muitas das vezes informal.
Buscar informações atualizadas sobre os serviços.
Fornecer respostas claras, concisas e úteis.
Citar as fontes das informações fornecidas.

⚙️ Funcionalidades

Resposta a perguntas sobre serviços sociais (saúde, assistência social, educação, segurança).
Busca de informações utilizando a ferramenta de busca do Google.
Fornecimento de detalhes como endereços, contatos, horários de funcionamento, documentos necessários, etc.
Tratamento de entradas inválidas do usuário (perguntas vazias).
Contexto da conversa para manter a continuidade do diálogo -- armazenamento de histórico para uma mesma sessão.

🛠️ Tecnologias Utilizadas

Google Colab
- Python 3
- Google Gemini API
- Google ADK (Agent Development Kit)
- Bibliotecas: os, google.colab.userdata, google.genai, google.adk.agents, google.adk.runners, google.adk.sessions, google.adk.tools, IPython.display, etc.
É necessário ter uma conta da Google, e uma chave API do Google AI Studio. Para mais informações, procure por vídeos tutoriais de como gerar sua API Key e vincular no seu projeto do Google Colab.
É utilizada o modelo gemini-2.5-flash-preview-04-17-thinking, mas em casos de falhas, pode ser alterado para o modelo estável no momento, gemini-2.0-flash.

⏯️ Uso

Execute o script Python (.ipynb ou .py).
- Como recomendação, use o Google Colab como ambiente de execução.
O chatbot será iniciado e você poderá interagir com ele através do console - será criado um box para inserir suas mensagens.
Faça perguntas sobre serviços sociais em uma determinada localização (de preferência a sua).
O chatbot fornecerá as informações solicitadas.
Para sair do chat, basta inserir umas dessas mensagens abaixo:
- ["sair", "encerrar", "fim", "tchau", "xau", "valeu", "vlw"]

Exemplo:

😃 Você: Quais os documentos necessários para o Bolsa Família?
👮 ACI: Os documentos necessários são RG, CPF, comprovante de residência e certidão de nascimento das crianças. [Fonte: Site do Governo Federal]

🌟 Contribuição

Contribuições são bem-vindas! Se você tiver sugestões de melhorias, correções de bugs ou novas funcionalidades, por favor, abra uma issue ou envie um pull request.

Como melhorias, podemos nos atentar na velocidade das respostas do modelo, bem como vincular a alguns serviços do próprio workspace Google, facilitando as tarefas do usuário, cliente dessas plataformas.

📜 Licença

Este projeto é licenciado sob a Licença MIT - 2025.

Créditos e Agradecimentos

Desenvolvido por Caio Cesar Vieira Cavalcanti
Projeto realizado como exercício de todo o aprendizado passado durante a Imersão IA Alura + Google Gemini, com a participação de ilustres e especiais mentores nesse mergulho ao "mundo da IA":

Gostaria de expressar minha especial gratidão à Alura por proporcionar esta valiosa oportunidade de aprofundar meus conhecimentos no fascinante universo da Inteligência Artificial.

Agradeço o aprendizado sobre tópicos importantes da IA, como:

O que é Inteligência Artificial?
Boas práticas de comandos de entrada para modelos de linguagem.
A arte da Engenharia de Prompt.
O desenvolvimento do primeiro chatbot.
A compreensão dos Agentes da IA.

Tudo isso utilizando o Google Gemini, uma plataforma inovadora e em constante evolução no campo das LLMs.

CesarImperas/agente-cidadao-inteligente