![\"Nic](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2019\/01\/nraboy-here-300x300.jpg\")
<\/p>\n<\/p>\n
Nic Raboy<\/a>\u00a0es un defensor de las tecnolog\u00edas modernas de desarrollo web y m\u00f3vil. Tiene experiencia en Java, JavaScript, Golang y una variedad de frameworks como Angular, NativeScript y Apache Cordova.\u00a0Nic<\/a>\u00a0escribe sobre sus experiencias de desarrollo relacionadas con facilitar la comprensi\u00f3n del desarrollo web y m\u00f3vil.<\/em><\/p>\n Hace poco escrib\u00ed un tutorial sobre <\/span>crear un AWS Lambda<\/span><\/a> que se comunicaba con el <\/span>Couchbase<\/span><\/a> NoSQL utilizando el lenguaje de programaci\u00f3n Go. Este tutorial anterior se basaba en un desarrollo sin servidor est\u00e1ndar, pero \u00bfy si quisi\u00e9ramos llevar las cosas al siguiente nivel? Por ejemplo, los dispositivos impulsados por Amazon Alexa, en la mayor\u00eda de las circunstancias, aprovechan AWS Lambda para funcionar. Entonces, \u00bfqu\u00e9 har\u00eda falta para que nuestra funci\u00f3n fuera compatible con Alexa?<\/span><\/p>\n En este tutorial vamos a ver c\u00f3mo trabajar con las peticiones de Amazon Alexa y responder adecuadamente para que Alexa retransmita un mensaje de audio al usuario. Los datos con los que respondamos vendr\u00e1n de nuestra base de datos y ser\u00e1n gestionados con el lenguaje de programaci\u00f3n Go.<\/span><\/p>\n <\/p>\n Si no ha visto mi tutorial anterior<\/a>te sugiero que le eches un vistazo antes de seguir leyendo. El tutorial anterior es corto y proporcionar\u00e1 alguna perspectiva en el desarrollo de funciones Lambda con Go y Couchbase.<\/span><\/p>\n A continuaci\u00f3n, cree un proyecto dentro de su **$GOPATH** con un archivo **main.go** en \u00e9l. Desde la l\u00ednea de comandos, ejecute lo siguiente para descargar nuestras dependencias:<\/span><\/p>\n <\/p>\n De nuestras dependencias, estamos descargando el SDK de AWS Lambda para Go as\u00ed como el SDK de Couchbase para Go. Tambi\u00e9n estamos descargando un paquete UUID para generar valores \u00fanicos para representar nuestras claves de documento, que es lo que ten\u00edamos en nuestro tutorial anterior. Sin embargo, esta vez estamos descargando otro paquete que contiene modelos para cada una de nuestras peticiones y respuestas. Alexa espera que tanto las peticiones como las respuestas est\u00e9n en un determinado formato JSON, que es pr\u00e1cticamente el \u00fanico prop\u00f3sito del paquete Alexa.<\/span><\/p>\n En el archivo **main.go**, a\u00f1ade el siguiente c\u00f3digo boilerplate:<\/span><\/p>\n \u00bfQu\u00e9 ocurre en el c\u00f3digo anterior?<\/span><\/p>\n After importing the downloaded dependencies, we can create a `Todo` data structure which will hold our data. Similar to the previous example, we are going to be storing todo list information and querying that information.<\/span><\/p>\n In the `main` function we are establishing a connection to our Couchbase instance and opening our bucket. It is important that our Couchbase instance be hosted somewhere because Lambda needs to be able to interact with it. This means you probably can’t test with Couchbase running on your local host.<\/span><\/p>\n When it comes to Alexa, things happen based on actions known as intents. These actions are typically a request to Alexa. For any given Skill you can typically interact with Alexa in numerous ways, hence numerous intents. Our Skill will have an `AboutIntent` for information, a `CreateTodoIntent` for saving data, and a `GetTodosIntent` for querying our data and returning it to the user. These intents will be controlled by our `IntentDispatcher` function.<\/span><\/p>\n The idea behind our `IntentDispatcher` is a request will come in from Alexa. Within the request, Amazon will figure out the correct intent and we can use that information. This intent information will be defined later on. Using the intent information we can call the correct function.<\/span><\/p>\n So let’s look at the `AboutIntent` function:<\/span><\/p>\n Si la funci\u00f3n es llamada, podemos usar el paquete Alexa para formatear nuestra respuesta como JSON correcto y devolverla. La respuesta tendr\u00e1 un t\u00edtulo y un texto que se le dir\u00e1 al usuario.<\/span><\/p>\n Now let’s look at the `CreateTodoIntent` function:<\/span><\/p>\n Si nuestro despachador elige la funci\u00f3n anterior, tomaremos los datos din\u00e1micos, conocidos como slot, y los insertaremos en Couchbase. Los datos de la ranura ser\u00e1n analizados por Amazon e incluidos en la solicitud, al igual que la intenci\u00f3n. Los datos de la ranura ser\u00e1n devueltos y hablados por Alexa cuando hayamos terminado.<\/span><\/p>\n La funci\u00f3n final es m\u00e1s larga, pero no mucho m\u00e1s complicada:<\/span><\/p>\n In the `HandleGetTodosIntent` we are querying the open bucket using N1QL. With the results we are forming a string of data to be returned to the user and spoken by Alexa.<\/span><\/p>\n Una vez completado el c\u00f3digo, podemos centrarnos en el despliegue.<\/span><\/p>\n Antes de que podamos desplegar en la tienda Skill, tenemos que preparar nuestro c\u00f3digo de funci\u00f3n para Lambda. Al igual que en el ejemplo anterior, tenemos que realizar una compilaci\u00f3n cruzada de nuestra aplicaci\u00f3n para Linux, que es lo que utiliza Lambda.<\/span><\/p>\n Desde la l\u00ednea de comandos, ejecute lo siguiente:<\/span><\/p>\n Make sure to change the `binary-name` with that of the name of your actual binary file created from the previous build command. If you can’t run the `zip` command, go ahead and archive the file however makes the most sense.<\/span><\/p>\n Con el archivo **handler.zip** en la mano, ve al panel de gesti\u00f3n de Lambda (https:\/\/console.aws.amazon.com\/lambda) y crea una nueva funci\u00f3n utilizando los valores predeterminados. Aseg\u00farate de que est\u00e1s usando un proyecto Go.<\/span><\/p>\n Para el activador, elija **Alexa Skills Kit** y proceda a cargar su archivo ZIP. Para el **Handler** aseg\u00farate de proporcionar el nombre de tu archivo binario, no el nombre de tu archivo ZIP.<\/span><\/p>\n La \u00faltima cosa a tener en cuenta es su id ARN. Este valor ARN ser\u00e1 necesario cuando configuremos Alexa.<\/span><\/p>\n Ahora ve a la Alexa Developer Console (https:\/\/developer.amazon.com\/alexa\/console) para que podamos crear una nueva Skill. Como parte del proceso de creaci\u00f3n, tendr\u00e1s que hacer cuatro cosas:<\/span><\/p>\n <\/p>\n El nombre de la invocaci\u00f3n no tiene por qu\u00e9 coincidir con el nombre de tu Skill, pero deben ser palabras reales que se puedan pronunciar con todos los acentos. Si empiezas a inventarte palabras o utilizas palabras complicadas, buena suerte con Alexa a la hora de entender lo que dice la gente.<\/span><\/p>\n El endpoint es el ARN que copiaste en el paso anterior desde la consola de Lambda. Aseg\u00farate de pegarlo.<\/span><\/p>\n La mayor parte de nuestro trabajo consistir\u00e1 en crear intents, expresiones de ejemplo y nuestros datos din\u00e1micos de ranura. Tenemos que crear tres intentos para que coincida con lo que tenemos en nuestro c\u00f3digo Golang. Cada uno de nuestros intentos debe tener una lista de frases que activan el intento.<\/span><\/p>\n For example, the `GetTodosIntent` might have the following sample utterances:<\/span><\/p>\n <\/p>\n The more example phrases you have, the better your Skill will perform. Basically, the samples help Alexa determine which intent to trigger in your code. The `CreateTodoIntent` is where things will get a little complicated because we are expecting dynamic data.<\/span><\/p>\n Eche un vistazo a los siguientes ejemplos de enunciados:<\/span><\/p>\n <\/p>\n Notice that I have `{todo}` in the above samples which matches that of my slot in my code. The `{todo}` placeholder is actually a variable for dynamic information. This information will be saved to our database. However, we need to define what type of data `{todo}` is.<\/span><\/p>\n <\/p>\n Crear un tipo de ranura personalizada y darle algunos valores. Por ejemplo, he a\u00f1adido:<\/span><\/p>\n No necesitas una lista exhaustiva, pero son datos de aprendizaje para Alexa, y ayudan a Alexa a identificar qu\u00e9 tipos de informaci\u00f3n deben considerarse informaci\u00f3n sobre ranuras. El hecho de que un texto no aparezca en la lista no significa que Alexa no lo vaya a recoger.<\/span><\/p>\n En este momento, deber\u00eda ser capaz de construir su Skill. Escriba algunas frases de ejemplo en el portal de pruebas para verlas en acci\u00f3n antes de intentar desplegarlas.<\/span><\/p>\n Acabas de ver c\u00f3mo crear una Amazon Alexa Skill usando Golang y <\/span>Servidor Couchbase<\/span><\/a>. Esta fue una extensi\u00f3n de un tutorial anterior que escrib\u00ed titulado, Desarrollo de funciones AWS Lambda con Golang y Couchbase NoSQL.<\/a><\/span><\/p>\nCreaci\u00f3n de una funci\u00f3n lambda compatible con Amazon Alexa<\/span><\/h3>\n
go get github.com\/arienmalec\/alexa-go\r\n\r\ngo get github.com\/aws\/aws-lambda-go\/lambda\r\n\r\ngo get github.com\/satori\/go.uuid\r\n\r\ngo get gopkg.in\/couchbase\/gocb.v1<\/pre>\n
package main\r\n\r\n\r\n\r\nimport (\r\n\r\n\u00a0\u00a0\u00a0 \"github.com\/arienmalec\/alexa-go\"\r\n\r\n\u00a0\u00a0\u00a0 \"github.com\/aws\/aws-lambda-go\/lambda\"\r\n\r\n\u00a0\u00a0\u00a0 uuid \"github.com\/satori\/go.uuid\"\r\n\r\n\u00a0\u00a0\u00a0 gocb \"gopkg.in\/couchbase\/gocb.v1\"\r\n\r\n)\r\n\r\n\r\n\r\nvar bucket *gocb.Bucket\r\n\r\n\r\n\r\ntype Todo struct {\r\n\r\n\u00a0\u00a0\u00a0 ID \u00a0\u00a0string `json:\"id,omitempty\"`\r\n\r\n\u00a0\u00a0\u00a0 Text string `json:\"text,omitempty\"`\r\n\r\n\u00a0\u00a0\u00a0 Type string `json:\"type,omitempty\"`\r\n\r\n}\r\n\r\n\r\n\r\nfunc IntentDispatcher(request alexa.Request) (alexa.Response, error) {\r\n\r\n\u00a0\u00a0\u00a0 var response alexa.Response\r\n\r\n\u00a0\u00a0\u00a0 switch request.Body.Intent.Name {\r\n\r\n\u00a0\u00a0\u00a0 case \"GetTodosIntent\":\r\n\r\n\u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 response = HandleGetTodosIntent(request)\r\n\r\n\u00a0\u00a0\u00a0 case \"CreateTodoIntent\":\r\n\r\n\u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 response = HandleCreateTodoIntent(request)\r\n\r\n\u00a0\u00a0\u00a0 case \"AboutIntent\":\r\n\r\n\u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 response = HandleAboutIntent(request)\r\n\r\n\u00a0\u00a0\u00a0 }\r\n\r\n\u00a0\u00a0\u00a0 return response, nil\r\n\r\n}\r\n\r\n\r\n\r\nfunc HandleAboutIntent(request alexa.Request) alexa.Response { }\r\n\r\nfunc HandleCreateTodoIntent(request alexa.Request) alexa.Response { }\r\n\r\nfunc HandleGetTodosIntent(request alexa.Request) alexa.Response { }\r\n\r\n\r\n\r\nfunc main() {\r\n\r\n\u00a0\u00a0\u00a0 cluster, _ := gocb.Connect(\"couchbase:\/\/HOST_HERE\")\r\n\r\n\u00a0\u00a0\u00a0 cluster.Authenticate(gocb.PasswordAuthenticator{Username: \"todos\", Password: \"123456\"})\r\n\r\n\u00a0\u00a0\u00a0 bucket, _ = cluster.OpenBucket(\"todos\", \"\")\r\n\r\n\u00a0\u00a0\u00a0 lambda.Start(IntentDispatcher)\r\n\r\n}\r\n\r\n<\/pre>\nfunc HandleAboutIntent(request alexa.Request) alexa.Response {\r\n\r\n\u00a0\u00a0\u00a0 return alexa.NewSimpleResponse(\"About\", \"Created by Nic Raboy of The Polyglot Developer.\")\r\n\r\n}\r\n\r\n<\/pre>\nfunc HandleCreateTodoIntent(request alexa.Request) alexa.Response {\r\n\r\n\u00a0\u00a0\u00a0 todo := Todo{Text: request.Body.Intent.Slots[\"todo\"].Value}\r\n\r\n\u00a0\u00a0\u00a0 bucket.Insert(uuid.Must(uuid.NewV4()).String(), todo, 0)\r\n\r\n\u00a0\u00a0\u00a0 return alexa.NewSimpleResponse(\"Todo Created\", \"Added `\"+todo.Text+\"` to the list.\")\r\n\r\n}\r\n\r\n\r\n\r\n<\/pre>\nfunc HandleGetTodosIntent(request alexa.Request) alexa.Response {\r\n\r\n\u00a0\u00a0\u00a0 todos := \"\"\r\n\r\n\u00a0\u00a0\u00a0 query := gocb.NewN1qlQuery(\"SELECT text FROM `todos` AS todos\")\r\n\r\n\u00a0\u00a0\u00a0 rows, _ := bucket.ExecuteN1qlQuery(query, nil)\r\n\r\n\u00a0\u00a0\u00a0 var row Todo\r\n\r\n\u00a0\u00a0\u00a0 for rows.Next(&row) {\r\n\r\n\u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 todos += row.Text + \". \"\r\n\r\n\u00a0\u00a0\u00a0 }\r\n\r\n\u00a0\u00a0\u00a0 return alexa.NewSimpleResponse(\"Todo List\", todos)\r\n\r\n}\r\n\r\n<\/pre>\nDesplegar y probar la funci\u00f3n Lambda como una Alexa Skill<\/span><\/h3>\n
GOOS=linux go build\r\n\r\nzip handler.zip .\/binary-name<\/pre>\n
\n
what are my todos\r\n\r\nget me my list\r\n\r\nwhat is on my todo list\r\n\r\nget me my todos\r\n\r\n\r\n\r\n<\/pre>\n
add {todo} to my list\r\n\r\nsave {todo}\r\n\r\ncreate {todo} for my list<\/pre>\nwash car\r\n\r\nclean house<\/pre>\n
<\/h3>\n
Conclusi\u00f3n<\/span><\/h3>\n