Modo Agente y Herramientas Nativas

1. ¿Qué es el Modo Agente en ZeroChat?

El Modo Agente transforma la interacción pasiva de pregunta-respuesta en un bucle autónomo multivuelta (Agentic Loop).

Cuando planteas una tarea compleja, el modelo evalúa qué herramientas necesita, emite una llamada estructurada (Function Calling), ZeroChat ejecuta la herramienta en tu navegador y devuelve el resultado al modelo para que continúe resolviendo el problema hasta completar el objetivo.

Límite de turnos de seguridad (maxAgentTurns): En Ajustes puedes definir el máximo de turnos consecutivos del agente, entre 5 y 35 (15 por defecto), para limitar bucles y consumo de tokens.

2. Catálogo de Herramientas Integradas (Built-in Tools)

Herramienta	Descripción y Capacidades	Entorno de Ejecución
`execute_javascript`	Ejecuta JavaScript local para cálculos matemáticos, algoritmos, transformaciones de datos o procesamiento de cadenas, bajo supervisión técnica.	Web Worker local con límites de ejecución
`search_web`	Realiza búsquedas en tiempo real en Internet para obtener información de actualidad o documentación técnica reciente.	SearXNG o DuckDuckGo sin API key
`fetch_web_page`	Descarga el contenido de una URL pública y lo convierte a Markdown limpio eliminando publicidad y scripts innecesarios.	Cliente HTTP con protección anti-SSRF
`download_pdf`	Descarga un documento PDF desde una URL y extrae su texto para que el modelo pueda consultarlo.	Parser PDF en el navegador
`render_chart`	Genera visualizaciones gráficas interactivas nativas en SVG (líneas, barras, dispersión, etc.) insertadas directamente en la conversación.	Motor SVG cliente (`charts.js`)
`list_documents` `search_knowledge_base` `read_knowledge_chunk` `read_knowledge_image`	Herramientas para inspeccionar, buscar e indexar fragmentos de documentos cargados en la base de conocimiento local (RAG).	Motor Orama & IndexedDB local

agent_checkpoint permite al agente resumir hallazgos y decidir si continúa investigando o responde.

3. Ejecución de JavaScript bajo supervisión técnica

execute_javascript es una herramienta de apoyo para cálculos, procesamiento de datos y algoritmos. Su uso requiere el conocimiento y la supervisión activa de una persona usuaria técnica, que puede habilitarla o deshabilitarla desde la configuración.

Ejecución en Web Worker: Normalmente se realiza en un hilo independiente para no bloquear la interfaz durante cálculos o algoritmos pesados.
Límite de tiempo: Si el script supera el tiempo configurado, ZeroChat detiene el Worker.
Límites de salida: Se truncan los resultados excesivos y se limita el número de mensajes de consola para preservar la capacidad de respuesta.
APIs restringidas para cálculos: El Worker neutraliza APIs de red y de creación de subprocesos que no son necesarias para esta herramienta.

4. Tarjetas de Herramientas Interactivas (Tool Cards)

Cuando el agente invoca una herramienta durante una conversación, ZeroChat muestra una Tool Card en el flujo de mensajes que refleja el estado de la operación en tiempo real:

Cabecera con estado: Muestra un spinner animado durante la ejecución y un check verde o icono de alerta al terminar.
Entrada y salida colapsables: Puedes desplegar la tarjeta para ver los argumentos exactos pasados a la función y el resultado devuelto por la herramienta.
Persistencia en historial: Si recargas la página o navegas entre conversaciones, las tarjetas de herramientas se restauran fielmente con sus desplegables operativos.