Merge branch 'main' into GitHubReview

Author: devk8s

ai/ai-document-understanding/README.md

@@ -23,7 +23,7 @@ Reviewed: 17.10.2024
 - [Cloud Coaching - Boost Your Oracle AI Services](https://youtu.be/VVWTqqlIEhg)
     - Learn how to Develop a Multi-Chain Document Evaluation Apps with Oracle Generative AI, Document Understanding, and Integration Cloud.
 
-- [Blog: Document Evaluation Tool using OCI Generative AI, Document Understanding & Integration Cloud](https://github.com/oracle-devrel/technology-engineering/tree/main/ai-and-app-modernisation/ai-services/generative-ai-service/doc-evaluation-genai)
+- [Blog: Document Evaluation Tool using OCI Generative AI, Document Understanding & Integration Cloud](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/generative-ai-service/doc-evaluation-genai)
     - In this article, we'll explore how to make a handy tool that helps to evaluate documents using Oracle Generative AI, OCI Document Understanding, and Oracle Integration Cloud (OIC). This application combines a low-code approach to orchestrate LLM AI services and applications using Oracle Integration Cloud and Generative AI prompting techniques for tasks like document key criteria extraction, summarization, and evaluation.
 
 - [Cloud Coaching - How to code and develop a Web (or Mobile) Application with Visual Builder that uses and leverages OCI Document Understanding Service](https://youtu.be/0oHixpA9JDc?si=3CWh0d2RpuEzzLKU)

ai/ai-speech/README.md

@@ -2,7 +2,7 @@
 
 OCI Speech is an AI service that applies automatic speech recognition technology to transform audio-based content into text. Developers can easily make API calls to integrate OCI Speech’s pre-trained models into their applications. OCI Speech can be used for accurate, text-normalized, time-stamped transcription via the console and REST APIs as well as command-line interfaces or SDKs. You can also use OCI Speech in an OCI Data Science notebook session. With OCI Speech, you can filter profanities, get confidence scores for both single words and complete transcriptions, and more.
 
-Reviewed: 17.10.2024
+Reviewed: 13.11.2024
 
 # Table of Contents
 
@@ -22,8 +22,6 @@ Reviewed: 17.10.2024
 
 - [Cloud Coaching - Boost Your Oracle AI Services](https://youtu.be/VVWTqqlIEhg)
     - Integrate OCI AI Speech Service and Generative AI Summarization with Oracle Integration Cloud and Visual Builder
-- [Blog: Integrate OCI AI Speech Service and Generative AI Summarization with Oracle Integration Cloud & Visual Builder](https://github.com/oracle-devrel/technology-engineering/tree/main/ai-and-app-modernisation/ai-services/generative-ai-service/speech-genai)
-    - OCI Speech is an AI service that applies automatic speech recognition technology to transform audio-based content into text. Generative AI, The Large Language Model (LLM) analyzes the text input and can generate, summarize, transform, and extract information. Using these AI capabilities, we built a low code application- “Integrate OCI AI Speech Service and Generative AI Service for Summarization in Visual Builder " to invoke AI Speech REST API to convert audio files into text and then further invoke the Generative AI REST API to Summarize it.
 - [Demos built using OCI Python SDK](https://github.com/luigisaetta/oci-speech-demos)
 - [AI Speech console demo](https://youtu.be/EWBSoSLNph8)
 - [Cloud Coaching - Unlock the potential of enterprise Oracle GenAI](https://www.youtube.com/watch?v=dtvP0DU7Mdg)
@@ -34,6 +32,7 @@ Reviewed: 17.10.2024
         - Integrate Python and Oracle Functions for backend processing.
         - Build a user-friendly interface with Oracle Visual Builder Cloud Service. 
          -Download, and preview transcribed text.
+- [Podcast Generator](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/ai-speech/podcast-generator)
 
 ## Architecture Center
 

ai/ai-speech/podcast-generator/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ai/ai-speech/podcast-generator/Podcast-md/README.md

@@ -0,0 +1,67 @@
+# Podcast Generator with Oracle AI and Low-Code
+Welcome to this guide on building a groundbreaking application that uses Oracle's AI-powered tools to generate high-quality podcasts effortlessly. Leveraging the Oracle Cloud Infrastructure (OCI) GenAI and AI Speech (Text-to-Speech) services, this solution transforms written content into engaging, natural-sounding audio.
+The application is designed to streamline podcast production through advanced AI capabilities. Starting from a simple text input, the app uses GenAI to generate a structured podcast script. It then enhances the speech output with SSML (Speech Synthesis Markup Language), which gives the audio a natural flow, making it sound like a professional recording. The result is a high-quality audio experience that can cater to a wide range of content needs and audiences.
+This application is built using Oracle Visual Builder Cloud Service (VBCS), a powerful low-code platform that simplifies development and accelerates the creation of robust applications without extensive coding. With this low-code approach, even complex workflows are straightforward to set up, allowing developers to focus on leveraging AI's potential for high-quality audio synthesis.
+This AI-powered solution not only automates and optimizes the podcast creation process but also allows content creators to deliver professional audio content at scale efficiently.
+# **1. Prepare your user**
+   
+   In Oracle Cloud Infrastructure (OCI), API keys are used for secure authentication when accessing OCI resources through REST APIs. OCI API keys consist of two parts: a Public key and a Private key. You use the OCI console to generate the Private/Public key pair.
+   Generate API Keys using OCI Console
+    To Generate the API Keys using OCI Console:
+
+  - Login into your OCI Account.
+   ![alt text](ak1.png)
+  - Click on the Profile icon at the top-right corner and select your Profile hyperlink.
+   ![alt text](ak2.png)
+  - Under Resources section at the bottom-left, select API Keys and then click Add API Key.
+   ![alt text](ak3.png)
+  - The Add API Key dialog is displayed. Select Generate API Key Pair to create a new key pair.
+  ![alt text](ak4.png)
+  - Click Download Private Key. A .pem file is saved to your local device. You do not need to download the public key and click Add button.
+  ![alt text](ak5.png)
+  
+
+
+# **2.Pick you compartment**
+Identify the compartment you're currently working within. Navigate to 'Identity' -> 'Compartments'. Locate your compartment and make a note of its OCID (Oracle Cloud Identifier)
+
+# **3.Open Visual Builder**
+## Import Visual Builder project
+* Open Visual Builder and click on the "Import" button. Choose "Application from file".
+* Drop the zip project file
+* Provide a name and an ID, for example "Podcast_Generator". Click on Import button.
+ ![alt text](import_project.jpg)
+  
+## Configure REST APIs authentication
+* Open the recently created project.
+ 
+* Click on Services button (left side) and click on "Backends"
+ ![alt text](services.jpg)
+
+* Now, click on TTS, and Servers to edit server authentication.
+![alt text](edit_tts.jpg)
+
+* Click the pencil to provide the OCI Crendentials
+ ![alt text](edit_tts_2.jpg)
+
+* Provide the crendentials you got during the step 1.
+ ![alt text](signature.jpg)
+
+* Repeat the same process with the GenAI backend.
+
+## Provide your compartmentId 
+* Provide compartmentId default value in the project variable named "comparmentid" that you got during the step 2.
+ ![alt text](compartmentid.jpg)
+
+#  **4.Preview the application**
+* Now can provide a topic in the text area and click "generate" button. 
+ ![alt text](preview.jpg)
+
+* Automatically a podcast script will be created and will generate the audio podcast using the Cindy and Bob voices
+  ![alt text](generated.jpg)
+
+## Notes
+* It is important to note that, as of the time of writing this tutorial, the Speech-to-Text service is available exclusively in the Phoenix region.
+
+## I hope you liked it.
+Author: Jesús Brasero