Herramientas

Las 63 herramientas del Conector MCP, por dominio. Las marcadas ✍️ Escritura exigen credencial con acceso completo (full); las que mutan datos del tenant piden además confirmación (confirmar=true). El resto son de lectura y funcionan con read. Todo opera solo sobre tu tenant.

En detalle: las que más vas a usar

actualizar_config_bot ✍️

Edita el borrador del Prompt Builder (merge parcial: solo los campos que mandás). No afecta al bot hasta publicar_config_bot.

Parámetro	Tipo	Descripción
cambios	objeto	{ variable: valor } con los campos del wizard a cambiar
esperado_actualizado	texto (opcional)	control de concurrencia optimista

// entrada
{ "cambios": { "tone": "cercano", "greeting": "¡Hola! Bienvenido a La Espiga 🥖" } }
// salida → confirma qué quedó en el borrador (no publicado)
{ "estado": "borrador_actualizado", "campos": ["tone", "greeting"] }

cargar_conocimiento ✍️

Crea una entrada de KB. Inmediata (no requiere publicar).

Parámetro	Tipo	Descripción
pregunta	texto	la consulta (FAQ) o la situación (protocolo)
respuesta	texto	la respuesta o la regla imperativa
tipo	"faq" | "protocol"	por defecto faq — ver FAQ vs Protocolo

{ "pregunta": "¿Hacen envíos?", "respuesta": "Sí, a todo el país en 48h.", "tipo": "faq" }

programar_seguimiento ✍️

Encola un mensaje outbound a un lead (respeta pacing anti-ban y ventana de 24h).

Parámetro	Tipo	Descripción
lead_id	texto	el lead destinatario
cuando	texto	momento del envío (ej. fecha/hora)
mensaje	texto	el contenido
confirmar	bool	true para aplicar (sin él, devuelve preview)

Ver el negocio

Herramienta	Qué hace
estado_conexion	Verifica la credencial y devuelve tu tenant.	Lectura
resumen_negocio	Resumen de actividad (leads, conversaciones, métricas) de N días.	Lectura
metricas_agente	Números duros: tasa de handoff, preguntas sin responder, leads por etapa, conversión, mensajes promedio.	Lectura
estado_agente	Estado del bot: activo/pausado, canales conectados.	Lectura
uso_del_plan	Consumo del plan del tenant.	Lectura
listar_leads	Lista leads, filtrable por etapa del funnel.	Lectura
conversaciones_atencion	Conversaciones que requieren atención humana (handoffs).	Lectura
listar_conversaciones	Todas las conversaciones recientes (con nº de mensajes), para tomar una muestra representativa.	Lectura
leer_conversacion	Historial de mensajes de una conversación.	Lectura

Copiloto de mejora del agente

Herramienta	Qué hace
ver_prompt_efectivo	El system prompt final que usa el bot (rol + Prompt Builder + capas + bloques v2), no el borrador del wizard.	Lectura
probar_bot	Manda un mensaje de prueba efímero y devuelve la respuesta real del bot (mismo pipeline que prod) sin crear conversación/lead/memoria ni enviar nada. Consume cuota de LLM → tope diario. Devuelve un session_id: re-pasalo para continuar el mismo hilo multi-turno (máx 20 turnos, 30 min) y reproducir bugs que solo aparecen a varios turnos.	✍️ Escritura

Loop de mejora

ver_prompt_efectivo + metricas_agente para diagnosticar → actualizar_config_bot para ajustar → probar_bot para A/B (probá 2-3 mensajes antes/después; si el problema aparece recién a varios turnos —mezcla de idiomas, sobre-indagación, handoff falso— re-pasá el session_id para continuar el mismo hilo). El prompt optimizar_agente orquesta todo esto sobre conversaciones reales.

Prompt Builder — personalidad del bot

Herramienta	Qué hace
ver_definicion_prompt_builder	Los 9 pasos del wizard, sus campos y opciones válidas.	Lectura
listar_roles_agente	Roles (cargos) válidos para el tenant.	Lectura
ver_config_bot	Config publicada hoy + si hay borrador pendiente.	Lectura
actualizar_config_bot	Edita el borrador (merge parcial). No afecta al bot aún.	✍️ Escritura
publicar_config_bot	Aplica el borrador — regenera el prompt (destructivo).	✍️ Escritura

Flujo recomendado

ver_definicion_prompt_builder → listar_roles_agente → ver_config_bot → actualizar_config_bot (borrador) → revisar con el dueño → publicar_config_bot. Publicar reconstruye el system prompt completo: confirmá siempre antes.

Conocimiento (KB)

Herramienta	Qué hace
listar_conocimiento	Lista FAQs y protocolos, con filtro y búsqueda.	Lectura
cargar_conocimiento	Crea una FAQ (faq) o un protocolo (protocol).	✍️ Escritura
editar_conocimiento	Edita una entrada existente.	✍️ Escritura
activar_desactivar_conocimiento	Activa o pausa una entrada.	✍️ Escritura
borrar_conocimiento	Elimina una entrada.	✍️ Escritura
preguntas_sin_responder	Preguntas de usuarios que el bot no supo responder.	Lectura
responder_pregunta_pendiente	Responde una pendiente y la agrega al KB.	✍️ Escritura
descartar_pregunta_pendiente	Descarta una pendiente.	✍️ Escritura

FAQ vs. Protocolo

FAQ: respuesta a una consulta (“cuando pregunten X, respondé Y”). Protocolo: regla imperativa que el bot sigue siempre (“ante un reclamo, pedí el N° de pedido y derivá”). Los protocolos tienen un tope activo — usalos para conducta, no para datos sueltos.

Fuentes y documentos

Herramienta	Qué hace
listar_fuentes_conocimiento	Fuentes conectadas (Google Sheets, documentos).	Lectura
conectar_google_sheet	Conecta una hoja de Google como fuente de KB.	✍️ Escritura
sincronizar_conocimiento	Re-sincroniza una fuente.	✍️ Escritura
desconectar_fuente	Desconecta una fuente (quita sus entradas).	✍️ Escritura
agregar_documento_conocimiento	Carga un lote de entradas como un documento.	✍️ Escritura
agregar_web_al_conocimiento	Descarga una web pública y devuelve su texto limpio para estructurarlo en FAQs (la carga real se hace con agregar_documento_conocimiento). Solo URLs públicas.	✍️ Escritura

Reglas del agente — salida

Herramienta	Qué hace
listar_reemplazos · crear_reemplazo · borrar_reemplazo	Reemplazos de palabras/patrones en la salida del bot.	Lectura / ✍️ / ✍️
listar_frases_prohibidas · crear_frase_prohibida · borrar_frase_prohibida	Frases que el bot nunca debe decir.	Lectura / ✍️ / ✍️
listar_directivas_estilo · crear_directiva_estilo · borrar_directiva_estilo	Directivas de estilo (positivas/negativas).	Lectura / ✍️ / ✍️

Memoria institucional

Herramienta	Qué hace
listar_memoria	Memoria aprendida, filtrable por estado/fuente.	Lectura
aprobar_memoria · rechazar_memoria	Aprueba o rechaza un ítem de memoria.	✍️ Escritura
editar_memoria · borrar_memoria	Edita o elimina un ítem.	✍️ Escritura
aprobar_sugerencia_kb · rechazar_sugerencia_kb	Gestiona sugerencias de KB derivadas de la memoria.	✍️ Escritura

CRM — leads, contactos y tickets

Herramienta	Qué hace
ver_lead	Detalle de un lead.	Lectura
etiquetar_lead	Agrega/quita etiquetas.	✍️ Escritura
agregar_nota_lead	Agrega una nota interna.	✍️ Escritura
cambiar_etapa_lead	Mueve el lead en el funnel.	✍️ Escritura
listar_tickets	Tickets del tenant, filtrable por estado.	Lectura
buscar_contactos · ver_contacto	Busca y ve contactos.	Lectura
etiquetar_contacto · agregar_nota_contacto	Etiqueta un contacto o le agrega una nota.	✍️ Escritura

Seguimientos (outbound)

Herramienta	Qué hace
listar_seguimientos	Seguimientos programados.	Lectura
programar_seguimiento	Programa un mensaje outbound a un lead.	✍️ Escritura
cancelar_seguimiento	Cancela un seguimiento.	✍️ Escritura

Surveys (mystery shopping)

Herramienta	Qué hace
listar_encuestas · ver_encuesta	Encuestas del tenant.	Lectura
listar_visitas · ver_visita	Visitas (respuestas), filtrable por estado/sucursal.	Lectura
asignar_visita	Asigna una visita a un número de teléfono.	✍️ Escritura