Crear un enriquecimiento semántico

Antes de crear un enriquecimiento

Considere qué tipo de contexto desea proporcionar:

• ¿Está definiendo un término comercial o una medición?
• ¿Está explicando cómo calcular algo?
• ¿Está proporcionando directrices de calidad de datos para un campo específico?
• ¿Está describiendo una relación entre objetos?
• ¿Está estableciendo un filtro o condición predeterminados?

Esto ayuda a determinar el ámbito correcto (espacio de datos, objeto o campo) y cómo formular la declaración de enriquecimiento.

Crear un enriquecimiento

1. Navegue a la vista de lista Enriquecimientos semánticos.
2. Haga clic en Nuevo enriquecimiento semántico.
3. Introduzca un Nombre que identifique claramente el propósito del enriquecimiento. Ejemplo: "Definición de cliente activa" o "Orientación de campo de ingresos".
4. Seleccione el ámbito:
   • Objeto: Se aplica a un objeto de lago de datos (DLO) u objeto de modelo de datos (DMO) específico. Utilizar para directrices específicas de objetos.
   • Campo: Se aplica a un campo específico dentro de un objeto. Utilizar para la interpretación a nivel de campo.
5. Si seleccionó el ámbito Objeto o Campo, seleccione el objeto o campo de destino en el menú desplegable.
6. En el campo Declaración semántica, escriba su enriquecimiento en un lenguaje claro y sin formato. Sea específico acerca de cuándo y cómo se aplica la regla. Puede redactar enriquecimientos de múltiples frases para reglas comerciales complejas. Ejemplos:
   • "Los clientes activos son aquellos con estado = 'Activo' y al menos un pedido en los últimos 90 días."
   • "Utilice amount_usd__c para cálculos de ingresos. Este campo representa el tamaño de la negociación en dólares estadounidenses".
   • "Al filtrar email_address, utilice siempre comparaciones en minúsculas porque algunos datos heredados tienen valores de mayúsculas y minúsculas mezclados".
   • "Las oportunidades de alto valor se definen como amount_usd__c superior a 100.000 $ y la etapa es igual a 'Propuesta' o 'Negociación'. Para el análisis regional, utilice el campo region__c, no el estado de la dirección de facturación. Las oportunidades históricas de alto valor anteriores a 2023 utilizaron un umbral diferente de 50.000 $ debido a ajustes de inflación".
7. (Opcional) Agregue Etiquetas para organizar enriquecimientos relacionados. Utilice etiquetas coherentes como "ingresos", "segmentación de clientes" o "calidad de datos" para facilitar la búsqueda y gestión de enriquecimientos más adelante. Las etiquetas son solo para la organización y no afectan a los enriquecimientos que recupera el agente.
8. (Opcional) Marque Crítico si este enriquecimiento siempre debe ser considerado por el agente. Utilícelo para reglas comerciales fundamentales o restricciones de calidad de datos. Marcar demasiados enriquecimientos como Críticos causa hinchazón de contexto y ralentiza las consultas, por lo que utilícelo con moderación.
9. (Opcional, pero recomendado) Agregue resúmenes de búsqueda para mejorar la recuperación de enriquecimiento semántico. Estas son palabras clave o frases que espera que aparezcan en las preguntas de los usuarios. Por ejemplo, si la declaración semántica define el valor de toda la vida del cliente, agregue resúmenes de búsqueda como "CLV" y "valor de toda la vida del cliente".
10. Haga clic en Guardar.

Redacción de declaraciones semánticas efectivas

Una declaración semántica enseña al agente cómo convertir una pregunta de lenguaje sin formato en la consulta correcta contra sus datos. Cada declaración efectiva responde a tres preguntas:

• ¿Cuál es la regla? La instrucción que debe seguir el agente.
• ¿Por qué existe? El razonamiento detrás.
• ¿Qué sucede si se ignora? La respuesta equivocada que intenta evitar.

El "por qué" importa más. Una regla sin razonamiento se sigue literalmente y se interrumpe en cualquier pregunta que no esperaba. Una regla con razonamiento permite al agente gestionar casos que nunca escribió. Compare una declaración débil que solo proporciona la regla con una declaración sólida que agrega el razonamiento y la consecuencia:

• Débil (solo regla): "Filtrar siempre Estado = 'Activo'."
• Fuerte (regla, razonamiento y consecuencia): "Filtre siempre Estado = 'Activo' en cada consulta. La tabla almacena registros de clientes activos y archivados. Sin este filtro, los resultados se mezclan en clientes archivados que ya no son relevantes. Esto se aplica incluso cuando el usuario pregunta por un cliente nombrado".

Siga estas directrices cuando escriba una declaración:

Sea específico

En vez de "Utilizar el campo de ingresos", escriba "Utilizar amount_usd__c para cálculos de ingresos porque representa el tamaño de la negociación en dólares estadounidenses y se rellena de forma coherente".

Explicar el por qué

No solo establezca una regla, explique el motivo. "Filtrar por estado = 'Activo' porque los clientes inactivos no deben aparecer en los informes."

Utilizar ejemplos

Al definir cálculos, muestre la fórmula o la lógica. "Valor de vida útil del cliente = total_ingresos / months_active * average_customer_lifespan_months."

Condiciones de estado claramente

Si una regla solo se aplica en ciertos casos, digamos cuándo. "Para consultas de oportunidad, excluya stage = 'Cerrada perdida' a menos que se solicite explícitamente."

Evitar la jerga

Redacte en lenguaje normal que el agente pueda analizar. Si debe utilizar términos específicos de dominio, defínalos.

Prácticas recomendadas para declaraciones semánticas

• Una regla por declaración. No combine reglas no relacionadas. Cuando el agente recupera una declaración, extrae todo, de modo que una declaración que cubre cinco temas agrega cuatro reglas irrelevantes cada vez que una coincide.
• Lidera con la regla y luego explica el por qué. Indique la instrucción primero, luego el razonamiento, luego la consecuencia de equivocarse.
• Di lo que no debes hacer. Si dos campos o valores son fáciles de confundir, asigne un nombre explícito al incorrecto. "Nunca utilice la fecha de envío para preguntas de ingresos" es tan valioso como asignar un nombre al campo correcto.
• Detalle valores que el agente no puede adivinar. El agente ve nombres de campo, no los valores dentro de ellos. Enumere el conjunto válido cuando sea corto y no obvio.
• Aclare formatos y unidades. Si un número se almacena como un multiplicador, un porcentaje, o en céntimos, dígalo. De lo contrario, "menos de 2 veces" o "más del 50%" se lee mal.
• Adjunte cada declaración al destino correcto más restringido. Una regla sobre un campo pertenece a ese campo. Una regla que abarca varios campos pertenece al objeto. Esto mantiene las preguntas no relacionadas limpias y aflora la regla correcta en el momento correcto.
• Utilice Critical solo para reglas que se aplican a casi todas las preguntas. Siempre se aplica una declaración Crítica. Las declaraciones no críticas solo se extraen cuando la pregunta coincide con sus resúmenes de búsqueda. Reserve Critical para reglas universales y mantenga el recuento pequeño.
• Escriba resúmenes de búsqueda en las palabras que sus usuarios realmente escriben. Estas son las frases desencadenantes que afloran una declaración no crítica. Utilice frases, sinónimos y abreviaturas reales, no descripciones técnicas.

Tipos de contexto que puede agregar

Las declaraciones semánticas pueden capturar muchos tipos de contexto comercial. Los tipos comunes incluyen:

Probar su enriquecimiento

Tras crear un enriquecimiento, pruébelo formulando al agente una pregunta que debería desencadenarlo. Revise la respuesta del agente y compruebe la sección Ver más detalles para ver si el enriquecimiento se aplicó correctamente. Si el agente no utilizó el enriquecimiento como se espera:

• Asegúrese de que el enriquecimiento es Activo.
• Compruebe que el ámbito (espacio de datos, objeto o campo) coincide con su pregunta.
• Revise la declaración semántica para ser más específica o agregue etiquetas relevantes.
• Si el enriquecimiento es fundamental, márquelo como Crítico.

Siguientes pasos

Consulte Gestionar enriquecimientos semánticos para obtener información acerca de cómo modificar, desactivar o eliminar enriquecimientos a medida que evoluciona su modelo de datos.