apidays Paris 2024 - Harnessing AI for API Business Documentation in a Devportal CMS: Lessons and Experiments, Kristof Van Tomme, Pronovix

Harnessing AI for API Business Documentation in a Devportal CMS: Lessons and Experiments
Kristof Van Tomme, CEO & Co-Founder at Pronovix

Green IO Conference
apidays Paris 2024 - The Future API Stack for Mass Innovation
December 3 - 5, 2024

------

Check out our conferences at https://www.apidays.global/

Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8

Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io

Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/

Transcript

1. Harnessing AI for API Business Documentation in a Devportal CMS: Lessons and Experiments
3. OAS spe cification Busine ss docume ntation
4. @kvantomme 4
5. 13+ yrs d ocs 8+ yrs d e vportals 20+ Fortune 500 13+yrs d ocs 8+yrs d e vportals 20+Fortune 500
6. With Pronovix you can now Build devportals with an Open CMS SAAS AND Steer your roadmap towards value
8. Pronovix confidential and proprietary Part I Why do you ne e d busine ss docume ntation on a de ve lope r portal?
9. Pronovix confidential and proprietary Developer eXperience and Operational m aturity are the dimensions most often used to define the scope of a developer portal Typical De vportal Program 1.1. Typical aspects usually considered when building a devportal
10. Pronovix confidential and proprietary Bottom up, de ve lope r-le d
11. Pronovix confidential and proprietary Bottom up, de ve lope r-le d Succe ssful de ve lope r portal and API program
12. Pronovix confidential and proprietary Bottom up, de ve lope r-le d Top down, e xe cutive supporte d Succe ssful de ve lope r portal and API program
13. Pronovix confidential and proprietary DEVPORTAL VALUE COMPASS 3 TYPES OF VALUE • Developer eXperience • Operational excellence • Business alignment 2024 API Marketplace Platform portal API portal
14. Pronovix confidential and proprietary Need all 3 types of value for lasting success
15. Pronovix confidential and proprietary Need all 3 types of value for lasting success But business alignment is hard
16. Pronovix confidential and proprietary The missing ingre die nt: Busine ss Alignme nt To ensure the long -term success and im pact of a developer portal, it's crucial to align its goals with strategic business priorities. Without this alignm ent, there's a risk that the portal m ight not receive the sustained attention and resources it needs to achieve its full potential. 1.2. The perfect developer portal recipe
17. Pronovix confidential and proprietary The outcome Strate gic Busine ss Value De ve lope r e fficie ncie s & m arke ting Ope rational cost savings & e ffe ctive ne ss
18. Pronovix confidential and proprietary Bottom up, developer-le d Top down, e xe cutive supporte d Successful de ve lope r portal and API program Re ason 1: Exe cutive support Strate gic Busine ss Value De ve lope r e fficie ncie s & m arke ting Ope rational cost savings & e ffe ctive ne ss
19. Pronovix confidential and proprietary Se arch Engine Optimization Ge ne rative Engine Optimization
20. Pronovix confidential and proprietary Voice search is becoming more dominant, and queries are more detailed
21. Pronovix confidential and proprietary Re ason 2: Conte nt de pth & proxim ity Content depth Content proxim ity
22. Use cases are some of the best possible content marketing
23. Worked examples and other business docs also help with sales enablement 23
24. Pronovix confidential and proprietary Re ason 3: He lp pe ople e xplain API value <a href="https://www.vecteezy.com/free-png/bulb-png">Bulb Png PNGs by Vecteezy</a>
25. Pronovix confidential and proprietary Part II Why use a CMS for your de vportal?
26. Pronovix confidential and proprietary Whe n to use a CMS for your de vportal Access Control Workflows SEO GUI Authoring
27. Pronovix confidential and proprietary People collaboratively creating better content
28. Pronovix confidential and proprietary People collaborating with AI to create better content
29. Pronovix confidential and proprietary Part III Cre ating busine ss docs with an LLM
30. Pronovix confidential and proprietary You can prompt an LLM to generate business documentation from an OAS
31. Pronovix confidential and proprietary The result is easier to read for non -technical people with “JSON blindness”
32. Pronovix confidential and proprietary Use an LLM to generate a JSON template layout directly didn’t work
33. Pronovix confidential and proprietary Asking an LLM to fill out a structured template works, can even select icons
34. Pronovix confidential and proprietary But the real value will come from collaborative centaur chain of thought reasoning
35. Pronovix confidential and proprietary Part IV Drupal CMS as an AI platform
36. Pronovix confidential and proprietary The Drupal community is adopting a composable architecture for its AI strategy
37. Pronovix confidential and proprietary Build on the work lead by Freelygive LTD
38. Pronovix confidential and proprietary Drupal AI module composable capabilitie s - LLM model abstraction layer - AI Chat explorer - try it out for LLM models - automaters: automated content management actions - agents: lineair & asynchronous using a kanban UI - vector embedding e.g. for better search - assistant
39. Pronovix confidential and proprietary Part V Bonus
40. Pronovix sponsored a Google Vertex integration for Drupal
41. Exploring AI products (e.g. try -out, monetisation, & chargebacks) in developer portals
42. Want to hear more?
43. Developer portal mailing list bit.ly/devportals visit us at Booth 34 44 Pronovix confidential and proprietary
44. Pronovix confidential and proprietary THANK YOU! Email kristof@pronovix.com Office Phone +36 62 648 005 Company number + 36 62 202 093