Configure the AI-powered Smart Help to search content
As an administrator, you can configure the Smart Help feature for the authors. The Smart Help service is secured by Adobe IMS auth-based authentication. Integrate your environment with Adobe’s secure token-based authentication workflows and start using the new Smart Help feature. The following configurations help you to add the AI configuration tab to a folder profile. Once added, you can use the Smart Help feature in the Web Editor.
Create IMS configurations in Adobe Developer Console
Perform the following steps to create IMS configurations in Adobe Developer Console:
-
Launch Adobe Developer Console.
-
After successfully logging in to Developer Console, you’ll view the Home screen. The Home screen is where you can easily find information and quick links, including top-navigation links to Projects and Downloads.
-
To create a new empty project, select Create new project from the Quick start links.
{width="550"}
Create a new project. -
Select Add API from the Projects screen. The Add an API screen appears. This screen displays all available APIs, Events, and services for Adobe products and technologies with which you can develop applications.
-
Select the I/O Management API to add it to your project.
Add I/O Management API to your project. -
Create a new OAuth credential and save it.
{width="3000"}
Configure OAuth credential to your API. -
In the Projects tab, choose the OAuth Server to Server option and then select the newly created credentials.
-
Select the OAuth Server-to-Server link to view the credential details of your project.
{width="800"}
Connect to the project to view the credential details.
-
Return to the Projects tab and select Project overview on the left.
{width="500"}
Get started on the new project.
-
Click the Download button on the top to download the service JSON.
{width="500"}
Download the JSON service details.
You have configured the OAuth authentication details and downloaded the JSON service details. Keep this file handy as it’s required in the next section.
Add IMS configuration to the environment
Perform the following steps to add IMS configuration to the environment:
- Open Experience Manager and then select your program, which contains the environment you want to configure.
- Switch to the Environments tab.
- Select the environment name, which you want to configure. This should navigate you to the Environment Information page.
- Switch to the Configuration tab.
- Update the SERVICE_ACCOUNT_DETAILS JSON field. Ensure you are using the same name and configuration as given in the following screenshot.
{width="800"}
Add the environment configuration details.
Once you have added the IMS configuration to the environment, perform the following steps to link these properties with AEM Guides using OSGi:
-
In your cloud manager Git project code, add the below given two files (for file contents, view Appendix).
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
-
Ensure that the newly added files are getting covered by your
filter.xml
. -
Commit and push your Git changes.
-
Run the pipeline to apply the changes to the environment.
Once this is done, you should be able to use the Smart Help feature.
Appendix appendix
File:com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
Content:
{
"service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
}
Once you have configured, the Smart Help
icon is displayed in the right panel of the Web Editor. Select the icon to view the Smart Help panel.
For more details, view the AI-powered Smart Help to search content section in the Experience Manager User Guide.