Agente con Tool Use — Groq + OpenWeatherMap + ExchangeRate API

Agente conversacional en Python que usa Groq como LLM con soporte de tool use (function calling). El agente puede consultar el clima de una ciudad y el tipo de cambio entre monedas en tiempo real.

Diagrama de flujo

Funcionamiento

1. El usuario ingresa una consulta en lenguaje natural.
2. El modelo (llama-3.3-70b-versatile vía Groq) decide qué herramienta(s) invocar.
3. El agente ejecuta las funciones correspondientes contra APIs externas.
4. El modelo genera una respuesta final con los datos obtenidos.

Herramientas disponibles

Tool	API	Descripción
buscar_clima	OpenWeatherMap	Temperatura y descripción del clima de una ciudad
buscar_tipo_de_cambio	open.er-api.com	Tasa de cambio entre dos monedas (códigos ISO, ej: USD, ARS)

Configuración

Crear un archivo .env en la raíz del proyecto con las siguientes variables:

API_KEY_GROQ=tu_api_key_de_groq
API_KEY_WEATHER=tu_api_key_de_openweathermap

• Groq API Key: console.groq.com
• OpenWeatherMap API Key: openweathermap.org
• ExchangeRate API: no requiere key (endpoint público)

Instalación y uso

pip install -r requirements.txt
python agente.py

Ejemplo de consulta:

¿Qué querés consultar? ¿Cómo está el clima en Buenos Aires y cuánto vale el dólar en pesos?

Estructura del proyecto

.
├── agente.py          # Lógica principal del agente
├── .env               # Variables de entorno (no subir al repo)
├── requirements.txt   # Dependencias
└── README.md