LicitaLAB

Analiza el mercado histórico de un PRODUCTO o SERVICIO en compras públicas: busca compras similares y devuelve, en una sola respuesta, comparables (organismo, estado, precio adjudicado, proveedor ganador, fecha), un benchmark de precios (mín/p25/mediana/promedio/p75/máx y precio del comparable publicado más recientemente; no es la fecha de adjudicación) y los proveedores y compradores ordenados por monto adjudicado, con un nivel de confianza del match. Úsala para precios de referencia ("¿cuánto se ha pagado por…?") y competencia por producto ("¿quién suele ganar…?", "¿quién le compra … al Estado?"). Semilla: el `code` de una oportunidad (con `item_index` opcional) o una descripción libre del producto en `query`. Para el historial completo de UN proveedor usa providerReportTool; para el detalle de UNA oportunidad, findOpportunityTool. Lee `seed` para confirmar qué texto se usó. Disponible para Chile y Perú. Si falta la semilla responde `status: "invalid_input"`; para Colombia y con API key, `status: "unsupported"`.

analyzeProductPricesTool

Responde preguntas de uso de la plataforma LicitaLab (funcionalidades, guías, preguntas frecuentes) a partir del help center. Devuelve una respuesta ya redactada (`answer`), no artículos, y recuerda la conversación por usuario y workspace. No sirve para datos de licitaciones, proveedores ni del seguimiento.

searchSupportTool

Busca una oportunidad de compra pública por su código exacto (no por nombre ni palabras clave). Clasifica el tipo automáticamente y devuelve el body de la API tal cual: header (code, type, type_label, name, status), buyer, dates, items[].offers[], winners[], y notes/items_omitted cuando aplica. Cada fecha UTC trae su `<campo>_local` en hora del país, e `is_closed` ya calculado. Si el código no existe responde `status: "not_found"`; con API key, `status: "unsupported"`. Si trae `multiple_matches: true`, presenta los `candidates` (entidad, título, estado, fecha, monto) en el mismo orden y pide elegir, sin elegir tú; luego vuelve a llamar con el `code` y `type` del elegido, o con `buyer` para filtrar por entidad.

findOpportunityTool

Lee o busca en los documentos de una oportunidad (bases administrativas, técnicas, anexos). Usa exactamente uno de dos modos. `query`: una pregunta en lenguaje natural; devuelve los pasajes más relevantes de todos los documentos a la vez, con archivo y página, y la primera consulta puede tardar mientras se indexan. `documentName`: el nombre exacto de un archivo tal como lo entrega listOpportunityDocumentsTool; devuelve su texto (hasta 50000 caracteres; si se recortó trae `truncated: true` y `total_chars`). No trae los datos de la ficha (ítems, montos, fechas): para eso está findOpportunityTool. En modo `query`, interpreta `status`: `ok` → responde con `chunks`; `partial` → responde con `chunks` y advierte que la respuesta puede estar incompleta porque no se leyeron los archivos de `pending_documents` (si `indexing_triggered` es true se están indexando: reintentar en ~60 s); `indexing` → aún no hay texto: pide reintentar en 30-60 s sin inventar contenido; `empty` → sin documentos legibles; `unsupported` → no disponible para este país/tipo, código inexistente (lo dice `error`) o código ambiguo: si trae `candidate_opportunities`, preséntalas y vuelve a llamar con el `code` elegido; `error` → falla técnica, reintentable. Solo `ok` y `partial` implican que se leyó texto.

getOpportunityDocumentTool

Lista los documentos de una oportunidad por su código: nombre, tamaño, extensión y `supported` (si se puede extraer texto). No devuelve contenido. En PE/CO acepta el código público y lo resuelve al interno; si varias oportunidades lo comparten, devuelve `candidate_opportunities`: preséntalas y vuelve a llamar con el `code` elegido. Si el código no existe responde `status: "not_found"`: no digas que la oportunidad no tiene documentos. Con API key solo se resuelven las Compras Menores de Perú (código CM- o id numérico); en lo demás pasa el código interno.

listOpportunityDocumentsTool

Lista oportunidades en seguimiento del workspace con filtros (estado, ejecutivo, línea de negocio, fechas, organismo, región, monto). Paginación cursor-based. Sólo devuelve oportunidades del workspace autenticado. Cada fecha UTC trae su `<campo>_local` en hora del país: usa esa. En Perú presenta `nomenclature` como código de la oportunidad (`code` es un id interno). `managed_status` 3 (Aceptado) es oferta admitida, no adjudicada: para saber si se ganó usa `resultado` (`adjudicada`). Disponible para Chile y Perú; para Colombia y con API key responde `status: "unsupported"`.

listInboxOpportunitiesTool

Reporte COMPACTO de un proveedor de compras públicas dado su RUT (Chile), RUC (Perú, 11 dígitos, ej. "20532492051") o NIT (Colombia, ej. "900.123.456-7"): resumen del período (participaciones, adjudicaciones, win-rate, montos ofertados/adjudicados, evolución mensual), top compradores y rubros, competidores (top_competitors, siempre incluido), top compradores por orden de compra (po_top_buyers, solo Chile) y hasta 20 oportunidades de detalle a nivel de proceso por página (cursor o "limit" hasta 50 disponibles para más), cada una con su MODALIDAD real de contratación (process_type), su presupuesto oficial en Colombia (estimated_amount) y, en Perú, si participó en consorcio (is_consortium). Filtra por ventana temporal RODANTE (10d/1m/3m/6m/1y), tipo de oportunidad y modo de participación. Usa include:["recent_awarded_items"] para sus últimos ítems adjudicados con precio unitario, e include:["lost_items_pricing"] para comparar su precio propio vs el del ganador en ítems donde perdió (competitividad de precios, "por qué pierde"). Úsala para el análisis de UN proveedor por RUT/RUC/NIT: historial de adjudicaciones, principales clientes, montos por período, participaciones y comparativos. No compara precios de un producto entre varios proveedores ni busca proveedores por rubro.

providerReportTool

Detalle de una oportunidad EN SEGUIMIENTO del workspace por código: estado del seguimiento (managed_status y `resultado`; 3 = Aceptado es oferta admitida, no adjudicada), ejecutiva asignada, líneas de negocio, montos y, si se perdió, la comparación ítem a ítem de tu precio contra el del ganador. La comparación trae como máximo las 50 filas con mayor brecha (`gap_pct` más alto); `competition.items_omitted` indica cuántas quedaron fuera. Los totales y `weighted_gap_pct` se calculan sobre hasta 500 ítems del proceso. Si responde `not_in_inbox`, la oportunidad no está en el seguimiento: búscala por código con findOpportunityTool. Cada fecha UTC trae su `<campo>_local` en hora del país: usa esa. En Perú presenta `nomenclature` como código. Disponible para Chile y Perú; para Colombia y con API key responde `status: "unsupported"`.

getInboxOpportunityDetailTool