> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de configuración de IA para clientes

> Leer y cambiar personalidad, instrucciones, límite de fotos y política de derivación existentes.

Rutas relativas a /m2m/v1. La conexión autenticada determina el tenant. ai\_settings:read y ai\_settings:write son permisos independientes con consentimiento explícito; escribir no implica leer. Las conexiones existentes no cambian. El Business Agent administrado conserva sus aprobaciones exactas para escritura.

| Ruta | Operaciones |
| - | - |
| /settings/ai/system-prompt | GET personalización actual; PUT reemplazo completo con expectedUpdatedAt |
| /settings/ai/asset-sharing | GET límite/versión; PUT maxImagesPerReply y expectedUpdatedAt |
| /settings/ai/handoff-policy | GET policy; PUT enabled/intents completos y expectedPolicyVersion |

## Leer y cambiar personalidad

Lee get\_ai\_settings primero. Devuelve baseStyle (default/professional/friendly/candid/quirky/efficient/cynical), emoji (yes/no), messageLength (default/short/long), conversationOpenness (strict/open), assistantName, customInstructions opcional, replyAutoFreezeMinutes y updatedAt. runtimePersonalization contiene campos almacenados/configured/verbose heredado; los campos principales normalizan valores del dashboard. compiledSystemPrompt es una vista previa, no el prompt completo. Una fila ausente puede usar reglas de respaldo del servidor; campos ausentes pueden diferir de los valores predeterminados del dashboard.

Actualizar requiere todos los campos de personalidad, customInstructions explícito y expectedUpdatedAt copiado de una lectura reciente (null solo si no se devolvió updatedAt). Conserva valores no solicitados. assistantName=null borra el nombre; customInstructions=null o vacío borra instrucciones. Omitir replyAutoFreezeMinutes conserva la pausa; admite enteros 0–120. Versión obsoleta/creación concurrente devuelve SETTINGS\_CONFLICT (409): vuelve a leer y reconcilia. Otros campos de automatización, reservas y recursos se conservan. Verifica tras guardar.

Las respuestas usan campos almacenados más instrucciones centrales, conocimiento, herramientas y política; la apertura no permite inventar hechos del negocio. candid/quirky/cynical llegan ahora al generador compatible. La personalización afecta clientes/Playground y borradores CRM mediante su propio resolver; no configura Support Copilot ni el Business Agent administrado.

## Fotos y derivación

get\_ai\_asset\_sharing\_settings/update\_ai\_asset\_sharing\_settings gestionan maxImagesPerReply, entero 1–15 (6 por defecto), con versión compartida de configuración. Los recursos/carpetas deben ser válidos, activos y aplicables; no crea conocimiento ni envía adjuntos.

get\_ai\_handoff\_policy devuelve enabled, knowledgeGapBehavior, workingHours, intents y policyVersion dentro de policy. Actualizar requiere enabled, intents completo y expectedPolicyVersion actual (default si no existe política almacenada). Conserva IDs de las reglas deseadas; nuevas reglas pueden omitir id y reciben IDs en el resultado. Límite normal de ocho reglas; políticas mayores existentes solo pueden reducirse sin agregar IDs. Omitir workingHours/knowledgeGapBehavior conserva valores. Alcances nuevos/cambiados deben referirse a propiedades activas del tenant. Horarios requieren los siete días distintos y horas HH:mm válidas en la zona horaria del negocio. Versiones obsoletas devuelven HANDOFF\_POLICY\_VERSION\_CONFLICT (409). El servicio programa proyecciones existentes después de persistir; ante fallos inciertos/de proyección, lee la política antes de reintentar. create\_handoff depende también de controles de despliegue/validación del runtime. Editar política no resuelve casos ni envía mensajes a clientes.

## Explicar una respuesta guardada

Primero descubre el mensaje y consulta get\_conversation\_answer\_trace con conversations:debug:read; pide contenido guardado acotado solo cuando haga falta. Conocimiento/configuración/política/generación actuales sirven para diagnóstico presente, no prueban versiones históricas ni peso causal. Declara capturas ausentes/caducadas/truncadas y vínculos/versiones faltantes. No reproduzcas herramientas, llames proveedores, actives captura, envíes mensajes ni cambies configuración solo para explicar una respuesta. Consulta [conocimiento](/es/api-docs/knowledge-api) y [guía MCP](/es/product-guides/getting-started/visito-mcp).

## Estado de publicación

Continuación local y validación sintética del 13 de octubre de 2026. Requiere servicios RAG/índices/API/orchestrator compatibles, herramientas actualizadas y consentimiento de nuevos permisos. No se cambiaron configuraciones de clientes, capturas ni datos de producción. Canales, conversaciones, Actions, automatización CRM y reservas conservan permisos/comportamiento propios.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.