Al agregar un nuevo paso a un Fin Procedure, el paso de instrucción es el paso predeterminado. El paso de instrucción es el más poderoso, permite definir una unidad coherente de trabajo para que Fin la ejecute en lenguaje natural.
Capacidades del paso de instrucción
Al ejecutar pasos de instrucción, por defecto Fin tiene acceso a las siguientes herramientas:
Para usar estas herramientas dentro de un paso de instrucción, simplemente escribe @ para abrir el menú de búsqueda.
Categoría | Herramienta | Descripción |
Controles de lógica y flujo | @Condition | Agrega lógica de ramificación (IF / ELSE). |
| @Run sub-procedure | Te permite reutilizar un flujo común sin reescribirlo, o un flujo complejo que quieras ocultar del flujo principal. |
| @Create sub-procedure | Construye un nuevo flujo anidado directamente desde tu editor actual. |
Operaciones de datos | @Read attribute | Indica a Fin que extraiga datos específicos de Intercom al contexto del procedimiento. Esto incluye detalles de People (como nombre), información de Company, estado de Conversation (como adjuntos) o atributos personalizados Temporary. Ejemplo @read name y saluda al usuario por su nombre. |
| @Update attribute | Puedes indicar a Fin que @update cualquier atributo de intercom.
NOTA: Fin puede solo actualizar el atributo de correo electrónico de People para leads anónimos sin correo electrónico o teléfono existente, y solo cuando un indicador de función está habilitado por el equipo de Intercom. En todos los demás casos, la solicitud de actualización es rechazada para proteger los datos de contacto. |
| @Create attribute | Crea un nuevo atributo al instante si el que necesitas aún no existe. |
Conocimiento y contexto | @Look up content | Indica a Fin que busque en tu Help Center o knowledge base externa información específica. Aprende más sobre @Look up content. |
| @Use data connector (Call an API endpoint) | Cuando @use un data connector, Fin llamará a ese endpoint de API. Optimiza para usar no más de un data connector por paso. |
| @Create data connector | Construye un nuevo flujo anidado directamente desde tu editor actual. |
Enrutamiento y finalización | @End | Termina el Procedure inmediatamente y lo devuelve a Fin. |
| @Handoff to team | Entrega la conversación a un equipo o compañero. |
| @Handoff to Workflow | Termina el Procedure y pasa al usuario a un Workflow. |
| @Switch procedure | Termina el procedure actual y comienza inmediatamente otro diferente. Esta es una transición unidireccional. Fin dejará el Procedure actual y entrará en el nuevo inmediatamente, pero no volverá al Procedure original una vez que termine el nuevo. @Switch no cuenta como una entrega de Procedure y no cambia el estado de resolución; no se marca como una resolución asumida ni como resultado de entrega de Procedure. |
Acciones de conversación | @Add note | Agrega un mensaje predefinido que aparecerá como nota para los compañeros en el inbox. |
| @Tag | Esto permite a Fin aplicar dinámicamente una etiqueta a una conversación. |
Nota:
Generalmente, si no puedes “@” la capacidad, entonces no está soportada. Por ejemplo, Fin no puede enviar correos electrónicos, hacer llamadas telefónicas o eliminar etiquetas.
Evita comandos en lenguaje natural como “ir a otro procedure”, “agregar una nota” o “verificar OTP del cliente”. Usa herramientas soportadas en su lugar.
Mejores prácticas
Hay dos principios de diseño de alto nivel al escribir instrucciones
Un paso de instrucción debe representar una unidad significativa de trabajo
Menos pasos bien diseñados que combinen coherentemente acciones relacionadas son mejores que muchos pasos pequeños separados. Al mismo tiempo, los pasos no deben ser demasiado grandes: como regla general limita el número de llamadas a data connector en un paso a una y reduce el número de update attributes o etiquetas a lo absolutamente necesario para que Fin pueda ejecutar más rápido.
❌ Ejemplo menos efectivo:
Step 1 - @read Email.
Step 2 - Ask for email if it's not there.
Step 3 - @use get_subscription_details
Step 4 - Send a reply listing every API field.
✅ Ejemplo más efectivo y mejor estructurado:
@read email. If it is not known, ask the user for their email before continuing. Then @use get_subscription_details and reply asking the user what they need help with. Include the user's current plan, plan status, and next renewal date in your reply.
Mantén las cosas simples y claras
Optimiza siempre para mantener las cosas simples y claras para que Fin pueda seguir tus instrucciones sin confundirse. Si un humano sin contexto no puede entender tus instrucciones, Fin tampoco las entenderá.
Usa verbos simples y concretos. Escribe pasos con verbos de acción cotidianos (preguntar, verificar, enviar, actualizar, escalar). Evita verbos abstractos o formales (validar, asegurar, realizar, facilitar).
❌ Ejemplo menos efectivo - No está claro qué es un número de pedido o número de seguimiento:
Collect the customers order number: Collect the customers order number and make sure it is valid and not a tracking number.
✅ Paso bien estructurado - Indica a Fin cómo es el número de pedido y qué hacer si el cliente no puede proporcionarlo:
Collect the customers order number:
If they provided a number but it is longer than 11 characters excluding the # at the start of the number, then let them know that it may be a tracking number and ask them for the order number again.
If the customer can not provide their order number do not continue @Escalate:Support team