Configure the AI-powered smart suggestions for authoring
As an administrator, you can configure the Smart Suggestions feature for the authors. The smart suggestion 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 suggestion feature. The following configuration help you to add the AI configuration tab to folder profile. Once added, you can use the smart suggestions 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.
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.
Configure OAuth credential to your API.
-
In the Projects tab, choose 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.
Connect to the project to view the credential details.
-
Return to the Projects tab and select Project overview on the left.
Get started on the new project.
-
Click the Download button on the top to download the service JSON.
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.
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 you cloud manager Git project code, add the below given two files (for file contents, view Appendix).
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.jsoncom.adobe.fmdita.smartsuggest.service.SmartSuggestConfigurationConsumer.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 on the environment.
Once this is done, you should be able to use the smart suggestions feature.
Appendix appendix
File:com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
Content:
{
"service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
}
File: com.adobe.fmdita.smartsuggest.service.SmartSuggestConfigurationConsumer.cfg.json
Content:
{
"smart.suggestion.flag":true,
"conref.inline.threshold":0.6,
"conref.block.threshold":0.7,
"emerald.url":"https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1",
"instance.type":"prod"
}
Smart Suggestions configuration details
Once you have configured, the smart suggestions icon is displayed in the right panel of the Web Editor. You can view the list of smart suggestions when you edit your topics. For more details, view AI based smart suggestions for authoring section in the Experience Manager User Guide.