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

# Perfil de IA

> Configura la personalidad y la referencia de flujo de trabajo del AI Agent para cumplir con los requisitos de servicios de marca personalizados

Usa el Perfil de IA para configurar el contexto de marca, las instrucciones y las acciones de tu agente. Prueba la configuración en la vista previa antes de publicar.

## Elegir un rol de AI Agent

Crea un agente de IA y elige el rol que deseas que desempeñe.

<Frame caption="Choose the role that best matches the task you want the agent to handle.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-create-service-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=51661e4297cccf5c0cb2df1dc94d98d7" alt="Formulario para crear AI Agent que muestra los roles disponibles y Servicio de atención al cliente seleccionado." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-create-service-annotated.svg" />
</Frame>

## Inicio rápido

Ya hemos preconfigurado todos los ajustes básicos. Puedes completar directamente la información de tu marca y luego chatear con la IA en el panel de vista previa a la derecha para ver cómo funciona. Si necesitas ajustar la configuración de la IA, solo ve a la sección correspondiente y edítala.

<Frame caption="Complete the agent profile and use Preview to test it before publishing.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=3466b5ef4209a28b3ff415a80e051fdc" alt="Ajustes del perfil de IA con Información básica y el panel de vista previa." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-annotated.svg" />
</Frame>

### Escribir instrucciones

En este módulo, puedes indicarle a la IA el flujo de trabajo general que debe seguir, el estilo de comunicación que debe usar, cómo manejar cuestiones de límites y más. Recomendamos dividir la orientación en varias partes:

| **Componente del prompt** | **Para qué se utiliza** | **Ejemplo** |
| - | - | - |
| **Flujo de trabajo** | Paso a paso, indícale al AI Agent cómo guiar la interacción con el usuario. | **1. Saludar:** Da la bienvenida al usuario de manera cálida y cortés.  <br />**2. Comprender la necesidad:** Pregunta qué está buscando, confirma brevemente la respuesta y evita hacer preguntas sucesivas rápidamente.  <br />**3. Aportar valor rápido:** Destaca un beneficio relevante en no más de 1-2 oraciones.  <br />**4. Recopilar información de contacto:** Después de aportar valor, solicita de forma natural los campos obligatorios de uno en uno, como el correo electrónico o el apodo. No solicites información innecesaria.  <br />**5. Gestionar el interés:** Si el usuario muestra un gran interés, ofrece una demostración o una conversación con un experto. Deriva a soporte humano si acepta.  <br />**6. Cerrar:** Pregunta si necesita algo más, luego agradece al usuario y despídete amablemente. |
| **Contexto** | Describe con quién interactúa el AI Agent y el propósito principal de la conversación. | Estás hablando con alguien que está conociendo nuestro producto o servicio. Tu objetivo es responder a sus preguntas iniciales y recopilar la información del cliente necesaria para el seguimiento. |
| **Rol y estilo de comunicación** | Explica el rol que debe desempeñar el AI Agent, el tono que debe usar y cómo debe comunicarse. | Eres un guía de ventas cálido, servicial y accesible que nunca presiona. Haz una pregunta a la vez. Mantén las respuestas claras, motivadoras y de no más de dos oraciones. |
| **Gestión del seguimiento** | Indícale al AI Agent qué hacer si el usuario no responde, incluyendo cuánto tiempo esperar y qué acción tomar. | Si no hay respuesta después de 5 minutos, envía: "Hola, solo quería saber si sigues ahí". Si sigue sin haber respuesta después de otros 5 minutos, envía un mensaje de despedida cortés y finaliza la conversación. La duración máxima del temporizador es de 60 minutos. |
| **Gestión de contingencias** | Explica cómo responder cuando la solicitud del usuario no sea clara, esté incompleta o quede fuera de las capacidades del AI Agent. | Si no comprendes la intención del usuario, primero confírmala de forma amigable. Si sigue sin quedar clara, deriva a soporte humano. |
| **Límites** | Define lo que el AI Agent no debe intentar hacer, como brindar asesoramiento legal, médico o financiero. | No inventes datos, procesos, precios o políticas que no estén contemplados en las instrucciones. No compartas información confidencial. Manténte en tu rol y nunca hagas suposiciones, des opiniones ni hagas promesas sin fundamento. |

### Escribir prompts de acciones

A partir de la guía, puedes definir acciones que se activen en ciertos escenarios especiales. Fuera del flujo de trabajo guiado, si ocurre un escenario de los descritos a continuación en una conversación con el usuario, la IA también tomará medidas según los requisitos de tu prompt.

Para cada acción, describe:

* **Cuándo** debe ocurrir (condiciones)
* Qué debe hacer el AI Agent

| **Acción** | **Qué puedes escribir en el prompt** | **Ejemplo** |
| - | - | - |
| **Finalizar conversación** | Indique al agente cuándo puede finalizar la conversación y si debe enviar un mensaje de cierre. | Finalice la conversación cuando el contacto confirme que su problema está resuelto y que no necesita más ayuda. |
| **Escalar a soporte humano** | Defina las situaciones en las que la IA debe transferir la conversación a un agente o equipo específico. | Si el usuario solicita un agente humano, transfiéralo a John. Si el usuario necesita ayuda con una solicitud de reembolso, transfiéralo al Equipo de soporte. |
| **Agregar etiqueta de contacto** | Describa las condiciones bajo las cuales se debe agregar una etiqueta específica al contacto. | Si el usuario muestra una fuerte intención de compra, agregue la etiqueta "Intención de compra". Si el usuario está interesado en el Producto A, agregue la etiqueta "Producto A". |
| **Actualizar propiedades del contacto** | Indique al AI Agent cuándo deben actualizarse las propiedades del contacto y qué propiedades tiene permitido modificar. | Actualice los campos relevantes cuando el usuario proporcione o confirme `{{Contact.Email}}` o `{{Contact.Order_address}}`. |

Las acciones solo pueden activarse de forma independiente cuando están habilitadas. Si una acción específica está deshabilitada, aún se puede utilizar en las instrucciones, pero no se puede activar de forma independiente fuera de ellas. Esto significa que, aunque la acción permanezca disponible en instrucciones predefinidas o playbooks, no se puede activar en otros contextos hasta que se vuelva a habilitar.

### Uso de variables, transferencia y etiquetas de contacto

<Frame caption="Select Variables to insert a contact field into your instructions.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-variables-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=dda97b51d22139bfe8cd08dea3013c18" alt="Menú de variables abierto desde las instrucciones del perfil de IA." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-variables-annotated.svg" />
</Frame>

**Variables**

**¿Qué son las variables?**

Las variables le permiten hacer referencia a información específica del contacto en los prompts de la IA. Piense en ellas como marcadores de posición que se completan automáticamente con datos reales del cliente.

**¿Cómo funcionan?**

Cada vez que necesite mencionar detalles de contacto como el nombre, correo electrónico, historial de compras o cualquier campo personalizado que haya creado, simplemente agregue variables en el prompt. El agente de IA puede comprender inteligentemente cuándo:

* Leer valores de campos (por ejemplo, "Hola `{{contact.name}}`")
* Actualizar campos según el contexto de la conversación (por ejemplo, “Solicite el `{{contact.phone_number}}` del cliente durante la conversación.”)

**Transferencia**

<Frame caption="Select Hand off to choose the destination used by your instructions.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-handoff-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=cf88b33447a070b1d0676d61e8e4b2c3" alt="Menú de transferencia con opciones de enrutamiento por equipo y agente." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-handoff-annotated.svg" />
</Frame>

**¿Qué es la transferencia?**

La función de transferencia le permite escalar una conversación desde el agente de IA a un agente humano cuando sea necesario.

Opciones disponibles:

* Asignar a un agente específico
* Asignar a un equipo
* Asignar al propietario
* Enrutar al propietario de la cuenta del contacto
* Asignar al responsable anterior

Cuándo usarla: configure reglas de transferencia para consultas complejas, problemas confidenciales o solicitudes que la IA no pueda resolver.

**Agregar etiquetas de contacto**

<Frame caption="Select Add contact tags to choose a tag referenced by your instructions.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-tags-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=88b601313c53452132a89584fdd0a50b" alt="Menú para agregar etiquetas de contacto que muestra etiquetas de demostración." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-tags-annotated.svg" />
</Frame>

**¿Qué son las etiquetas de contacto?**

Las etiquetas son distintivos que puede aplicar automáticamente a los contactos según su comportamiento o el contenido de la conversación.

Cómo utilizarlas: elija etiquetas específicas para aplicar cuando se cumplan determinadas condiciones durante la conversación.

Casos de uso comunes:

* Seguimiento de intereses: si el usuario pregunta por el “Producto A”, etiquételo automáticamente como “Interesado en Producto A”
* Categorización de problemas: etiquete contactos con “Problema de facturación” o “Soporte técnico”
* Calificación de clientes potenciales: etiquete a los prospectos como “Cliente potencial interesado” o “Requiere seguimiento”

Beneficios: las etiquetas le ayudan a segmentar contactos, activar flujos de trabajo automatizados y ofrecer una mejor personalización en futuras interacciones.


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