Smart Recommendations

In addition to knowing the maturity level of your APIs and getting recommendations, you can also download the contracts with the recommended changes already applied to them (Smart Recommendations).

Smart Recommendations are generated by Artificial Intelligence by Adaptive Governance. To download them, follow the steps below:

  1. Click “Discovery” in the side menu or click the card on the Adaptive Governance home page.

  2. Find the API for which you want to generate Smart Recommendations, then click the icon visualize button, located in the “Actions” column. “screen with list of APIs and indication of where to click to see details for the selected API”

  3. Click:

    • the DOCUMENTATION tab
      or

    • the card "Quality analysis".

    “screen with details of the selected API and indication of where to click”

  4. Click the Smart Recommendations button in the top right-hand area of the screen.
    “screen with details and indication of where to click”

  5. Adaptive Governance will generate the smart recommendations for the API. You don’t need to remain on the page while the process runs.

  6. At the end of this process, the Download button will become enabled. Click it and save the contract to your computer.

The Smart Recommendations button will be enabled when:

  • there is at least one violation in the API contract;

  • Adaptive Governance is enabled in the environment.

Result

When the contract generation process finishes, in addition to the button to download the contract ( E ) with the applied recommendations, you will have a summary containing:

  • A The result of the process, which can be:

    • Success: the contract was successfully generated.

    • Partial: the process was completed, but some recommendations could not be applied. Download the generated contract and submit it again for smart recommendation generation.

    • Failed: the process failed. Submit the contract again for smart recommendation generation.

  • B Number of corrected violations (Corrected), uncorrected violations (Remaining), and the total number of violations (Total).

  • C Comparison of the current maturity score with the score of the contract generated by the AI.

  • D Button to view the contract itself (Swagger).

screen with summary of smart recommendations

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]