Flujos recomendados

Estos flujos ayudan a ordenar cómo debería trabajar un agente con LicitaIQ MCP. El agente debe conservar el consentimiento del usuario antes de llamar una tool que prepare documentos.

Explorar el catálogo sin preparar documentos

1. search_tenders
2. get_tender
3. get_tender_status si necesitas saber qué acción sería posible después

Este flujo sigue disponible con trial vencido. No descarga ni procesa archivos y no consume cupos.

Buscar y preparar una licitación

1. search_tenders
2. get_tender_status
3. Con consentimiento explícito del usuario, activate_tender si el estado es details_not_loaded
4. Con consentimiento del usuario, download_tender_files cuando el estado sea files_not_started
5. refresh_tender_preparation y list_tender_files mientras haya descarga o procesamiento
6. search_tender_documents cuando ready_for_retrieval sea verdadero

activate_tender puede cargar la ficha general sin consumir una preparación cuando el estado es details_not_loaded. Sin embargo, el estado puede cambiar antes de ejecutar la tool: si la ficha ya está cargada, la misma tool puede iniciar la preparación. Por eso requiere consentimiento explícito en toda llamada y debes revisar el estado que devuelve antes de continuar. El cupo se descuenta una sola vez cuando se completa la preparación y los archivos descubiertos terminan descargados, procesados e indexados para consulta documental. Un estado partial con ready_for_retrieval: true permite consultar los archivos disponibles sin crear ni revertir ese consumo.

Preparar con orquestación automática

1. search_tenders
2. Con consentimiento del usuario, prepare_tender_for_agent
3. Si devuelve fetch_tender_details, espera a que get_tender_status indique files_not_started y vuelve a llamar prepare_tender_for_agent con ese consentimiento.
4. refresh_tender_preparation mientras haya descarga o procesamiento.
5. search_tender_documents cuando ready_for_retrieval sea verdadero.

Analizar documentos con evidencia

1. get_tender_status
2. list_tender_files
3. search_tender_documents o ask_tender
4. construir una respuesta usando los chunks y citas devueltos

LicitaIQ MCP entrega evidencia documental; la respuesta final la construye el agente conectado con su propio modelo.

Llevar una oportunidad al pipeline

1. get_tender
2. get_tender_status
3. add_tender_to_pipeline
4. update_pipeline_tender cuando cambie la etapa o responsable

Reintentar cuando algo falla

1. refresh_tender_preparation
2. Busca una entrada con state: failed y retryable: true.
3. Llama retry_tender_processing con su tender_id y file_ref.
4. Vuelve a actualizar el manifiesto.

No reintentes archivos available, skipped o aún en curso. Un bloqueo de Mercado Público no habilita reintentos automáticos para evadir CAPTCHA o controles de acceso.

Estados operativos importantes

• details_not_loaded: usa activate_tender para cargar la ficha general.
• files_not_started: la preparación todavía no comenzó; solicita consentimiento antes de download_tender_files.
• downloading_files o processing_files: espera y vuelve a revisar el manifiesto.
• ready_for_retrieval: ya puedes usar search_tender_documents.
• enriched: hay retrieval y enriquecimiento IA disponible.
• partial: hay documentos disponibles. Si ready_for_retrieval es verdadero, puedes consultarlos; revisa los fallos por archivo antes de reintentar. Ese estado no crea ni revierte el único consumo de la preparación.
• failed: revisa el manifiesto y el diagnóstico. Si Mercado Público denegó el acceso, no prometas un reintento ni una evasión de CAPTCHA.

Consulta también Tools disponibles y Preparación documental.