Skill - Site Search
Skill Type
Fallback
Overview
The Site Search skill uses Google to search your website and return the top result. The top results are displayed as an internal link or external link card so the user can navigate to that content.
Note: Default UI (a.k.a Auckland Theme) does not support internal link cards.
This skill is:
Built and owned by Soul Machines Ltd.
Only supported in English.
Powered by Google Custom Search API
Limitations
Currently not supported with the following skills: Elegant Failure, Knowledge Base Skill, and Translation Skill
Skill Demo
Configurations
Provide the following information in the Site Search Skill configuration screen in Digital DNA Studio. See Adding Skills to your Digital Person for detailed instructions:
Field | Type | Description |
---|---|---|
GOOGLE API KEY USED TO CONDUCT SEARCH (required) |
| Enter the API Key generated from Custom Search JSON API page. |
CUSTOM SEARCH ENGINE GENERATED ID (required) |
| Enter the search engine ID generated from google Programmable Search. For detailed instruction see section Creating a Programmable Search Engine for your Site. |
RESPONSE WHEN SHOWING RESULTS |
| Output phrase when showing results. The default is |
RESPONSE WHEN NO RESULTS FOUND |
| Output phrase when no results are found. The default is |
INTERNAL LINK OR EXTERNAL LINK |
| Internal link opens the links in the same tab (used with a widget). External link opens links in a separate tab, can be used on widget and default UI. |
IF INTERNAL LINK, NUMBER OF RESULTS THE DIGITAL PERSON SHOULD RETURN |
| The number of internal links that can be displayed can be configured to up to four, whereas the number of external links is restricted to one. |
Creating a Programmable Search Engine for your Site
To create a Programmable Search Engine:
Sign into Control Panel using your Google Account (get an account if you don't have one).
In the Create a new search engine page, add the pages you want to include in your search engine. You can include any sites you wish to, not just the sites you own. You can include whole site URLs or individual page URLs. You can also use URL patterns.
Click Create.
Select the search engine name from the Control Panel.
Copy the Search engine ID.
Â
IMPORTANT
The Google Custom Search API key allows only a certain number of searches a day, as determined by your administrator. For more information, see https://support.google.com/googleapi/answer/7035610.