Ejemplos

Seis casos reales, mostrando el prompt en lenguaje natural y la herramienta que el agente elige.

1. Seguir la producción de Vaca Muerta

Prompt: "Mostrame la producción de petróleo y gas de Vaca Muerta por año desde 2018."

Tool: query_production con formacion: "VACA MUERTA", fecha_desde: "2018-01", agrupar_por: "anio"

Por qué importa: Vaca Muerta es el principal play de shale del mundo fuera de EE.UU. El crecimiento año contra año sigue el pulso macro de Argentina.

2. Encontrar los mejores pozos por empresa

Prompt: "Top 10 pozos de YPF en Neuquén por producción acumulada de petróleo."

Tool: query_wells con empresa: "YPF", provincia: "NEUQUEN", limit: 10

Caso de uso: due diligence de inversión, valuación de activos, research M&A, benchmarking de operadores.

3. Comparar WTI y Brent en el tiempo

Prompt: "¿Cuál fue el promedio mensual del WTI en 2024?"

Tool: query_prices con serie: "WTI", fecha_desde: "2024-01-01", fecha_hasta: "2024-12-31", frecuencia: "mensual"

Caso de uso: mesas de trading comparando benchmarks internacionales contra crudos locales argentinos (Escalante, Medanito).

4. Inversión upstream por cuenca

Prompt: "¿Cuánto invirtieron los operadores en perforación en la cuenca Neuquina desde 2020?"

Tool: query_investments con cuenca: "NEUQUINA", concepto: "perforacion", anio_desde: 2020

Caso de uso: analistas energéticos, bancos con project finance, periodistas del sector.

5. Balance comercial energético de Argentina

Prompt: "Exportaciones argentinas de crudo en 2024."

Tool: query_trade con anio: 2024, flow: "export", producto: "crude"

Caso de uso: analistas macro modelando balance comercial, impacto cambiario y recaudación fiscal.

6. SQL custom

Prompt: "Para cada cuenca, ¿cuál es el ratio de pozos horizontales vs verticales perforados en 2024?"

Tool: execute_sql con una consulta como:

SELECT
  cuenca,
  COUNT(*) FILTER (WHERE tipo_pozo ILIKE '%horizontal%') as horizontales,
  COUNT(*) FILTER (WHERE tipo_pozo ILIKE '%vertical%') as verticales
FROM pozos
WHERE EXTRACT(YEAR FROM fecha_primera_prod) = 2024
GROUP BY cuenca
ORDER BY horizontales DESC

Cuándo usar SQL: las tools curadas cubren los casos comunes. Cuando necesitás joins cruzados, window functions o agregaciones a medida, bajás a SQL.

Tips para obtener buenas respuestas

• Arrancá con get_data_freshness si no estás seguro de qué tan reciente es el dato.
• Usá get_schema cuando el agente necesita saber qué columnas existen.
• Especificá fechas — sin filtros, las consultas suelen topar contra el límite de filas en tablas de millones de registros.
• Los nombres de cuencas van en mayúsculas en los datos (NEUQUINA, GOLFO SAN JORGE).
• Unidades: la producción viene en m³ y miles m³, los precios en USD/bbl, las inversiones en MMUSD y el comercio en USD FOB.