Agente de Viagens de IA

🛫 AI Travel Agent

Esta aplicação Streamlit é um Agente de Viagens com IA que gera itinerários de viagem personalizados utilizando o OpenAI GPT-4o. Automatiza o processo de pesquisa, planeamento e organização das tuas férias de sonho, permitindo-te explorar destinos emocionantes com facilidade.

Funcionalidades

• Pesquisa e descobre destinos de viagem emocionantes, atividades e alojamentos
• Personaliza o teu itinerário com base no número de dias que desejas viajar
• Utiliza o poder do GPT-4o para gerar planos de viagem inteligentes e personalizados
• Descarrega o teu itinerário como um ficheiro de calendário (.ics) para importar no Google Calendar, Apple Calendar ou outras aplicações de calendário

Como começar?

1. Clona o repositório do GitHub

git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd awesome-llm-apps/ai_agent_tutorials/ai_travel_agent

2. Instala as dependências necessárias:

**Comando para instalar as dependências**
npm install

pip install -r requirements.txt

3. Obtém a tua Chave de API da OpenAI

• Regista-te para uma conta OpenAI (ou o fornecedor de LLM da tua escolha) e obtém a tua chave de API.

4. Obtém a tua Chave de API da SerpAPI

• Regista-te para uma conta SerpAPI e obtém a tua chave de API.

5. Executa a Aplicação Streamlit

streamlit run travel_agent.py

Instalação

1. Certifica-te de que tens o Ollama instalado.
2. Executa o seguinte comando para instalar o modelo desejado:

ollama pull <modelo>

Execução

Para executar o modelo, utiliza o seguinte comando:

ollama run <modelo>

Exemplos de utilização

Exemplo 1: Pergunta simples

ollama run <modelo> "Qual é a capital de Portugal?"

Exemplo 2: Conversa

ollama run <modelo> "Olá! Como estás?"

Configuração

Podes configurar variáveis de ambiente para personalizar a execução do modelo. Por exemplo:

export OLLAMA_API_KEY="tua-chave-api"

Documentação

Para mais informações, consulta a documentação oficial do Ollama.

streamlit run local_travel_agent.py

Como Funciona?

O Agente de Viagens AI tem dois componentes principais:

• Investigador: Responsável por gerar termos de pesquisa com base no destino do utilizador e na duração da viagem, e por pesquisar na web atividades e alojamentos relevantes utilizando o SerpAPI.
• Planeador: Recebe os resultados da pesquisa e as preferências do utilizador para gerar um esboço de itinerário personalizado que inclui atividades sugeridas, opções de refeições e alojamentos.

Utilizando a Função de Download do Calendário

Após gerar o teu itinerário de viagem:

1. Clica no botão "Download Itinerary as Calendar (.ics)" que aparece ao lado do botão "Generate Itinerary"
2. Guarda o ficheiro .ics no teu computador
3. Importa o ficheiro na aplicação de calendário que preferires (Google Calendar, Apple Calendar, Outlook, etc.)
4. Cada dia do teu itinerário aparecerá como um evento de dia inteiro no teu calendário
5. Os detalhes completos das atividades de cada dia estão incluídos na descrição do evento

Esta funcionalidade torna fácil acompanhar os teus planos de viagem e ter o teu itinerário disponível em todos os teus dispositivos, mesmo offline.

Versão Local vs Cloud

• travel_agent.py: Utiliza o GPT-4o da OpenAI para itinerários de alta qualidade (requer chave de API da OpenAI)
• local_travel_agent.py: Utiliza o Ollama para inferência LLM local sem enviar dados para APIs externas (requer que o Ollama esteja instalado e a funcionar)