Actions on Google te permite extender la funcionalidad de Asistente de Google con Acciones. Las acciones permiten que los usuarios realicen tareas mediante una interfaz conversacional que puede ser desde un comando rápido para encender algunas luces o un individual, como jugar a un juego de preguntas y respuestas.
El SDK de Actions es un método para desarrollar la entrega de conversaciones sin con Dialogflow. Cuando usas el SDK de Actions, usas un paquete de Actions para asignar intents a su entrega. También debes proporcionar patrones de consulta en la Paquete de acción para definir frases de ejemplo que podrían decir tus usuarios.
CLI de gactions
Cuando desarrollas con el SDK de Actions, usas la línea de comandos gactions.
(CLI) para probar y actualizar tu proyecto de acciones. La CLI de gactions
también te ayuda a crear y administrar el paquete de acciones para tu acción de conversación.
Cómo crear acciones en tu paquete de acciones
Para crear acciones en tu paquete de acciones, debes asignar intents a la entrega. Una acción define un punto de entrada para iniciar conversaciones con un identificador llamado intent. Los intents se asignan a entregas, que procesan .
Por ejemplo, supongamos que quieres compilar un proyecto que contiene acciones para comprar algunos productos, comprobar el estado de los pedidos y mostrar ofertas diarias. Para definir intents que se activan, di lo siguiente:
- "Hey Google, habla con AcciónDeEjemplo".
- "Hey Google, habla con ExampleAction para comprar unos zapatos".
- "Hey Google, habla con AcciónDeEjemplo para revisar mi pedido".
- "Hey Google, habla con ExampleAction para mostrarme las ofertas de hoy".
El archivo JSON del paquete de acciones podría verse de la siguiente manera:
{
"actions": [
{
"name": "MAIN",
"intent": {
"name": "actions.intent.MAIN"
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "BUY",
"intent": {
"name": "com.example.ExampleAction.BUY",
"parameters": [{
"name": "color",
"type": "org.schema.type.Color"
}],
"trigger": {
"queryPatterns": [
"find some $org.schema.type.Color:color sneakers",
"buy some blue suede shoes",
"get running shoes"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "ORDER_STATUS",
"intent": {
"name": "com.example.ExampleAction.ORDER_STATUS",
"trigger": {
"queryPatterns": [
"check on my order",
"see order updates",
"check where my order is"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "DAILY_DEALS",
"intent": {
"name": "com.example.ExampleAction.DAILY_DEALS",
"trigger": {
"queryPatterns": [
"hear about daily deals",
"buying some daily deals",
"get today's deals"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
}
],
"conversations": {
"ExampleAction": {
"name": "ExampleAction",
"url": "https://www.example.com/ExampleAction"
}
}
}
Compila e implementa un webhook de entrega
Cuando se invoca una acción en tu proyecto, Actions on Google llama a de entrega para iniciar una conversación con los usuarios a fin de completar la acción.
En cada solicitud a tu webhook de entrega, recibes la entrada del usuario como un cadena de texto. Para procesar el intent, por lo general, se analiza la entrada de texto y para que devuelvan una respuesta. Este intercambio de ida y vuelta ocurre hasta que se cumple la política la conversación.
Sube tu paquete de acción
Una vez que crees tu paquete de Acción y implementes su entrega, puedes subir tu paquete de Actions a la Consola de Actions. La Consola de Actions Usa proyectos de acción para agrupar tu acción de conversación con metadatos como su revisión estado y el nombre visible en el directorio del Asistente. El proyecto también te permite definir metadatos sobre tu acción y administrarla y realizar un seguimiento de ella a través de la de aprobación.
Cuando tengas un proyecto, podrás subir tu paquete de Action que defina todas
tus acciones con la CLI de gactions.
Envía tu proyecto para que se apruebe y haz que esté disponible para los usuarios
Ejemplos
Para explorar los proyectos completados, consulta las muestras del SDK de Actions para Node.js y Java.