Execution Function

# Execution Function

# Introducción

La Execution function es el punto final de la ejecución de una acción. Define el cumplimiento de una acción. Maneja la ejecución real de la acción y da un mensaje final de éxito o fallo al usuario, después de la finalización de una acción. La respuesta al usuario puede ser texto o elementos visuales como una colección de tarjetas.

### Invocation Point

La Execution function se invoca en el punto final de una acción. Por defecto, el punto final de una acción viene después de que todos los valores de los params son solicitados y se completan con valores apropiados. Alternativamente, el punto final también puede ser activado desde la {{%link href="/es/convokraft/help/actions/bot-logic/deluge-functions/context-handler-function" %}}context handler function{{%/link%}} {{%badge%}}{{%bold%}}("todo" : "execute"){{%/bold%}}{{%/badge%}}. Después de que la execution function es invocada, la acción se completa y cualquier conversación posterior del usuario se considerará como una nueva acción.

# Input Arguments

Los {{%link href="/es/convokraft/help/actions/bot-logic/deluge-functions/defining-deluge-functions/#system-defined-input-arguments" %}}argumentos de entrada definidos por el sistema{{%/link%}} solo están disponibles como argumentos de entrada de la Execution function.

### Return Values

La execution function retorna un mapa en el siguiente formato:
	
{{%code class="language-javascript line-numbers" scroll="set-scroll" %}}{
"message" : "The reply message.",
"card" : { },
"broadcast" : { },
"followup" : { }      
}{{%/code%}}

Las claves presentes en el mapa retornado por la execution function se explican a continuación:

### message

Esto da un mensaje de texto como respuesta al usuario y esta clave es obligatoria. Las siguientes opciones de formato de texto son soportadas por ConvoKraft. Cualquiera de estas opciones puede ser usada en el mensaje de texto.

<table class="content-table">
        <thead>
            <tr>
                <th>Opción de formato</th>
                <th>Sintaxis</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>{{%badge%}}Bold{{%/badge%}}</td>
                <td>*text*</td>
            </tr>
            <tr>
                <td>{{%badge%}}Italic{{%/badge%}}</td>
                <td>_text_</td>
            </tr>
            <tr>
                <td>{{%badge%}}Underline{{%/badge%}}</td>
                <td>__text__</td>
            </tr>
            <tr>
                <td>{{%badge%}}Strikethrough{{%/badge%}}</td>
                <td>~text~</td>
            </tr>
            <tr>
                <td>{{%badge%}}Link{{%/badge%}}</td>
                <td>[label](URL_link)</td>
            </tr>
            <tr>
                <td>{{%badge%}}Highlight{{%/badge%}}</td>
                <td>`text`</td>
            </tr>
            <tr>
                <td>{{%badge%}}Heading{{%/badge%}}</td>
                <td>h1 - #Heading
                h2 - ##Heading
                h3 - ###Heading
                h4 - ####Heading
                h5 - #####Heading</td>
            </tr>
            <tr>
                <td>{{%badge%}}Bullet list{{%/badge%}}</td>
                <td>* first_item \n * second_item \n * third_item</td>
            </tr>
            <tr>
                <td>{{%badge%}}Numbered list{{%/badge%}}</td>
                <td>1. first_item \n 2. second_item \n 3. third_item</td>
            </tr>
            <tr>
                <td>{{%badge%}}Image{{%/badge%}}</td>
                <td>![alternate_text](image_URL)</td>
            </tr>
            <tr>
                <td>{{%badge%}}Blockquote{{%/badge%}}</td>
                <td>!text</td>
            </tr>
            <tr>
                <td>{{%badge%}}Table{{%/badge%}}</td>
                <td>| header1 | header2 | header3 | \n |------------|------------|------------| \n 
                    | value1 | value2 | value3 | \n 
                    | value1 | value2 | value3 |</td>
            </tr>
 </tbody>
</table>

El siguiente es un valor de ejemplo del argumento message:

{{%code class="language-javascript line-numbers" scroll="set-scroll" %}}message : "Your event has been created successfully"{{%/code%}}

### card

Esto da un mensaje con formato visual como respuesta al usuario. Una {{%badge%}}card{{%/badge%}} es una colección de elementos visuales como tablas, imágenes y más. El valor de esta clave es una lista de objetos de mapa. Cada objeto de mapa representa un elemento de UI en la tarjeta. Una sola tarjeta puede contener más de un elemento del mismo tipo. Cada elemento en la tarjeta se mostrará uno debajo del otro en el mensaje de respuesta y esta clave es opcional.

Para obtener más información sobre la lista de elementos de UI que son soportados en la {{%badge%}}card{{%/badge%}} de mensaje de respuesta de ConvoKraft, consulta {{%link href="/es/convokraft/help/actions/bot-logic/deluge-functions/deluge-object-reference/#card" %}}esta página{{%/link%}}.

El siguiente es un valor de ejemplo del argumento {{%badge%}}card{{%/badge%}}:

{{%code class="language-javascript line-numbers" scroll="set-scroll" %}}"card" : {
"type" : "note", 
"content" : "Your event details are displayed below"
{
"type" : "image", 
"image" : "event_details.png"
}
//agregar objetos de mapa
}
{{%/code%}}

### broadcast

Esto pasará cualquier dato que el bot deba recordar después de ejecutar la acción actual. El valor debe estar en formato de mapa y estará disponible para todas las acciones consecutivas durante toda la sesión. Esta clave es opcional. Puedes obtener más información sobre broadcast en {{%link href="/es/convokraft/help/actions/bot-logic/deluge-functions/deluge-object-reference/#broadcast" %}}esta página{{%/link%}}.

El siguiente es un valor de ejemplo del argumento {{%badge%}}broadcast{{%/badge%}}.

{{%code class="language-javascript line-numbers" scroll="set-scroll" %}}"broadcast" : {
"user_level" : "admin", 
"status" : "booked"
}
{{%/code%}}

### followup

Puedes configurar si el bot debe mostrar una lista de sugerencias o solicitar al usuario que invoque cualquier acción particular como seguimiento, después de completar la ejecución de la acción actual. Esta clave es opcional. Obtén más información sobre Action Followups y la estructura del valor de esta clave en {{%link href="/es/convokraft/help/actions/action-followups" %}}esta página{{%/link%}}.

El siguiente es un valor de ejemplo del argumento {{%badge%}}card{{%/badge%}}:

{{%code class="language-javascript line-numbers" scroll="set-scroll" %}}"followup":{
"suggestions":[
{
"message":"Would you like to set a reminder for this event",
"action":{
"name":"schedule remainder",
"params":[ 
{
"name":"event time",
"value":"11:00 am"
} 
//agregar otros parámetros según sea necesario  
]
}
}
{{%/code%}}

### Implementación

Una vez que {{%link href="/es/convokraft/help/actions/create-an-action" %}}crees una acción{{%/link%}} para tu bot de ConvoKraft y elijas configurar la respuesta basada en una lógica de negocio, debes definir las oraciones de ejemplo y los params respectivos para ella. Asegúrate de seguir los pasos listados a continuación para implementar la Execution function:

1. Después de configurar y guardar las {{%link href="/es/convokraft/help/actions/define-sample-sentences/" %}}oraciones de ejemplo{{%/link%}} y {{%link href="/es/convokraft/help/actions/define-params/" %}}params{{%/link%}} requeridos para una acción, se mostrará la página de detalles de la acción. Cambia a la pestaña Functions y haz clic en {{%bold%}}Edit Function{{%/bold%}} en la sección {{%bold%}}Execution function{{%/bold%}}.

2. Se abrirá el editor de Deluge de ConvoKraft donde puedes codificar tu lógica de negocio y guardar el script. Obtén más información sobre el editor de Deluge en {{%link href="/es/convokraft/help/actions/bot-logic/deluge-functions/defining-deluge-functions/#overview-of-the-code-editor" %}}esta página{{%/link%}}. Puedes probar los cambios en paralelo usando la función {{%link href="/es/convokraft/help/manage-a-bot/test-a-bot/" %}}Test this bot{{%/link%}}.

Invocation Point

La Execution function se invoca en el punto final de una acción. Por defecto, el punto final de una acción viene después de que todos los valores de los params son solicitados y se completan con valores apropiados. Alternativamente, el punto final también puede ser activado desde la context handler function (“todo” : “execute”). Después de que la execution function es invocada, la acción se completa y cualquier conversación posterior del usuario se considerará como una nueva acción.

Los argumentos de entrada definidos por el sistema solo están disponibles como argumentos de entrada de la Execution function.

Return Values

La execution function retorna un mapa en el siguiente formato:

copy

         {
"message" : "The reply message.",
"card" : { },
"broadcast" : { },
"followup" : { }      
}
    

Las claves presentes en el mapa retornado por la execution function se explican a continuación:

message

Opción de formato	Sintaxis
Bold	text
Italic	_text_
Underline	__text__
Strikethrough	~text~
Link	[label](URL_link)
Highlight	`text`
Heading	h1 - #Heading h2 - ##Heading h3 - ###Heading h4 - ####Heading h5 - #####Heading
Bullet list	* first_item \n * second_item \n * third_item
Numbered list	1. first_item \n 2. second_item \n 3. third_item
Image	![alternate_text](image_URL)
Blockquote	!text
Table	\| header1 \| header2 \| header3 \| \n \|------------\|------------\|------------\| \n \| value1 \| value2 \| value3 \| \n \| value1 \| value2 \| value3 \|

El siguiente es un valor de ejemplo del argumento message:

copy

         message : "Your event has been created successfully"

card

Esto da un mensaje con formato visual como respuesta al usuario. Una card es una colección de elementos visuales como tablas, imágenes y más. El valor de esta clave es una lista de objetos de mapa. Cada objeto de mapa representa un elemento de UI en la tarjeta. Una sola tarjeta puede contener más de un elemento del mismo tipo. Cada elemento en la tarjeta se mostrará uno debajo del otro en el mensaje de respuesta y esta clave es opcional.

Para obtener más información sobre la lista de elementos de UI que son soportados en la card de mensaje de respuesta de ConvoKraft, consulta esta página.

El siguiente es un valor de ejemplo del argumento card:

copy

         "card" : {
"type" : "note", 
"content" : "Your event details are displayed below"
{
"type" : "image", 
"image" : "event_details.png"
}
//agregar objetos de mapa
}

    

broadcast

El siguiente es un valor de ejemplo del argumento broadcast.

copy

         "broadcast" : {
"user_level" : "admin", 
"status" : "booked"
}

    

followup

El siguiente es un valor de ejemplo del argumento card:

copy

         "followup":{
"suggestions":[
{
"message":"Would you like to set a reminder for this event",
"action":{
"name":"schedule remainder",
"params":[ 
{
"name":"event time",
"value":"11:00 am"
} 
//agregar otros parámetros según sea necesario  
]
}
}

    

Implementación

Una vez que crees una acción para tu bot de ConvoKraft y elijas configurar la respuesta basada en una lógica de negocio, debes definir las oraciones de ejemplo y los params respectivos para ella. Asegúrate de seguir los pasos listados a continuación para implementar la Execution function:

Después de configurar y guardar las oraciones de ejemplo y params requeridos para una acción, se mostrará la página de detalles de la acción. Cambia a la pestaña Functions y haz clic en Edit Function en la sección Execution function.

Se abrirá el editor de Deluge de ConvoKraft donde puedes codificar tu lógica de negocio y guardar el script. Obtén más información sobre el editor de Deluge en esta página. Puedes probar los cambios en paralelo usando la función Test this bot.

Última actualización 2026-03-30 13:40:30 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit