# Agente de Viagens de IA

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

- Fonte: https://doutorai.pt/apps/ai-travel-agent
- Categoria: Agentes para Começar
- Dificuldade: Fácil
- Modelos: OpenAI, Llama
- Frameworks: Agno, Ollama (local)
- Corre local?: Sim (Ollama)
- Chaves necessárias: Nenhuma
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

## 🛫 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

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

```markdown
## 2. Instala as dependências necessárias:

```bash
# Comando para instalar as dependências
npm install
```
```

```bash
pip install -r requirements.txt
```

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

- Regista-te para uma [conta OpenAI](https://platform.openai.com/) (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](https://serpapi.com/) e obtém a tua chave de API.

5. Executa a Aplicação Streamlit
```

```bash
streamlit run travel_agent.py
```

# Para utilização local de LLM (com Ollama)

## Instalação

1. Certifica-te de que tens o [Ollama](https://ollama.com/) instalado.
2. Executa o seguinte comando para instalar o modelo desejado:

   ```bash
   ollama pull <modelo>
   ```

## Execução

Para executar o modelo, utiliza o seguinte comando:

```bash
ollama run <modelo>
```

## Exemplos de utilização

### Exemplo 1: Pergunta simples

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

### Exemplo 2: Conversa

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

## Configuração

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

```bash
export OLLAMA_API_KEY="tua-chave-api"
```

## Documentação

Para mais informações, consulta a [documentação oficial do Ollama](https://ollama.com/docs).

```bash
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)

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/ai-travel-agent