Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Skill Type

Status
colourGreen
titleINTENT MATCHER

Overview

The YouTube Skill will allow you to add YouTube channels or content videos in the Skills section of Digital DNA Studio. This skill can be customized to your needs, depending on what channel you want to focus on in your search. The skill takes the conversational request from the end-user and uses the YouTube API to search those channels and videos looking for matches. If there is a match, it will return a customizable conversation response along the lines of “Here is a video I found on that topic", along with the video link and description. The Digital Person will speak the conversational response, then the enterprise customer's UI will be responsible for showing the video.

Excerpt
hiddentrue

The YouTube Skill allows you to include YouTube channels or content videos as part of the Digital Person experience.

This Skill is:

  • Built and owned by Soul Machines Ltd.

  • Only supported in English.

  • Powered by the YouTube API.

Sample conversation:

“User: Can I see videos about [Topic]”

“Skill: I found several videos on that topic. Please indicate which you want to view.”

“User: Play the first one”

“Skill: Ok, Here you go (Plays the first video)”

Refer to Creating a Project | 3. Connect conversation and add skills for detailed instructions on adding Skills to your project.

Demo Video

youtube-demo.mp4

Prerequisites

For you to take advantage of the YouTube skill, your user interface must support cards or be able to capture and interpret @commands and make use of the variables included in the response JSON. This is built into the default theme but would require custom frontend development if you are using custom UI.

Configurations

Provide the following information in the YouTube Skill configuration screen:Image Removed

Image Added

Field

Type

Description

API Key (required)

Status
colourRed
titlerequired

TEXT

Enter your YouTube API Key. See Obtaining your YouTube API Key section to create a YouTube API key.

Example: 'VrG9Tp2HINyIrgQkYhIYAIzaSyAVD8yfbBTLUY8'

Channel Search

TEXT

This allows you to restrict the YouTube video search to your official channel. It is also possible to enter multiple comma-separated channel IDs or channel names.

Info

Note: Specify at least one channel or playlist.

This ID or name is available in the URL of your YouTube channel:

https://www.youtube.com/channel/<yourChannelId>

Example: 'Cpo1Pr6k5kxG9AUVm7bg6pXK', NatGeo

Playlist Search

TEXT

This allows you to restrict the video search to YouTube playlists. Also supports multiple comma-separated playlist ID search.

Info

Note: Specify at least one channel or playlist.

This ID is available in the URL of your YouTube playlist:

https://www.youtube.com/playlist?list=<yourPlaylistID>

Example: 'PLivjPDlt6ApQQX1ySA9v7jGYThLDjeksm'

Safe Search

TEXT

Enter either strict or open. When safe search is set to strict, it helps hide explicit content on the search results.

Spoken Phrase When Listing The Video Options

TEXT

Output phrases that can be customized to change the tone or wording of the verbal response. The default is 'I found several videos on that topic. Please indicate which you want to view'

Spoken Phrase When No Videos Found

TEXT

Output phrases when a matching video is not found. The default is 'Sorry, I couldn't find any videos for {0}'

Max Number Of Videos To Return

NUMBER

Specify the number of videos to be returned. It can be a number between 1 to 100. The default value is 3.

Obtaining your YouTube API Key

  1. Go to your Google Console > APIs & services > Library.

  2. Select YouTube Data API v3 from the list of APIs.

  3. Click Manage (If you are accessing the API for the first time you will see Enable button instead).

  4. Click Create Credentials and create a YouTube Data API v3 to access Public data.

  5. Copy the generated API key and paste it into the YouTube Skill Configuration Screen as shown above.

Contents

Table of Contents