Acerca de los bots de aptitudAbout skill bots

se aplica a: SDK V4APPLIES TO: SDK v4

Una aptitud es un bot que puede realizar un conjunto de tareas para otro bot.A skill is a bot that can perform a set of tasks for another bot. Otro bot puede consumir una aptitud, lo que facilita la reutilización.A skill can be consumed by another bot, facilitating reuse. De este modo, puede crear un bot orientado al usuario y ampliarlo mediante el consumo de sus propias aptitudes o las de terceros.In this way, you can create a user-facing bot and extend it by consuming your own or 3rd party skills. Con unas modificaciones menores, cualquier bot puede actuar como una aptitud.With minor modifications, any bot can act as a skill.

Bots de aptitud:Skill bots:

  • Implemente restricciones de acceso mediante un validador de notificaciones.Implement access restrictions via a claims validator.
  • Cuando corresponda, compruebe los parámetros de inicialización en la propiedad value de la actividad inicial.As appropriate, check for initialization parameters in the initial activity's value property.
  • Envíe mensajes al usuario de la forma habitual.Send messages to the user as normal.
  • Señale la finalización o cancelación de la aptitud mediante una actividad endOfConversation.Signal skill completion or cancellation via an endOfConversation activity.
    • Proporcione el valor devuelto, si existe, en la propiedad value de la actividad.Provide the return value, if any, in the activity's value property.
    • Proporcione un código de error, si existe, en la propiedad code de la actividad.Provide an error code, if any, in the activity's code property.

Para obtener más información, consulte Acerca de las aptitudes y Acerca de los consumidores de aptitud.For more information, see the skills overview and about skill consumers.)

Acciones de aptitudSkill actions

Algunas aptitudes pueden llevar a cabo una serie de tareas o acciones.Some skills can perform a variety of tasks or actions. Por ejemplo, una aptitud de tareas pendientes podría permitir la creación, actualización, visualización y eliminación de actividades a las que puede acceder como conversaciones discretas.For example, a to-do skill might allow create, update, view, and delete activities that can be accessed as discrete conversations.

Manifiestos de aptitudSkill manifests

Un manifiesto de aptitud es un archivo JSON que describe las acciones que puede realizar la aptitud, sus parámetros de entrada y salida, los puntos de conexión de la aptitud y los modelos de envío de la aptitud.A skill manifest is a JSON file that describes the actions the skill can perform, its input and output parameters, the skill's endpoints, and dispatch models for the skill.

Para obtener información sobre el esquema del manifiesto de aptitud, vea cómo escribir un manifiesto de aptitud.For information about the skill manifest schema, see how to write a skill manifest.