Merge branch 'main' into dependabot/pip/ai/generative-ai-service/smart-invoice-extraction/pillow-10.3.0

Author: jasperan

.DS_Store

@@ -2,3 +2,4 @@
 shared-assets/bastion-py-script/.oci/
 shared-assets/bastion-py-script/temp/
 temp/
+app-dev/app-integration-and-automation/oracle-integration-cloud/01-oic-connectivity-agent/README_tmp.html

.gitignore

@@ -0,0 +1,3 @@
+{
+    "recommendations": []
+}

.vscode/extensions.json

@@ -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: 13.11.2024
+Reviewed: 12.05.2025
 
 # Table of Contents
 
@@ -17,7 +17,7 @@ Reviewed: 13.11.2024
 
 # Team Publications
 - [AI Meetings: Meetings transcription](https://www.oracle.com/artificial-intelligence/automate-meeting-transcriptions/)
-- [Search Documents stored in Object Storage using Opensearch, Generative AI, Semantic Search, RAG](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3762)
+- [Create Podcasts with Generative AI](https://www.oracle.com/artificial-intelligence/create-podcasts-with-generative-ai/)
 
 ## Reusable Assets Overview
 
@@ -36,18 +36,19 @@ Reviewed: 13.11.2024
 - [Podcast Generator](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/ai-speech/podcast-generator)
 
 ## Architecture Center
-
+- [Implement a web-based user interface for interacting with Oracle Cloud Infrastructure Generative AI Agents](https://docs.oracle.com/en/solutions/oci-genai-speech/index.html)
 - [Use OCI Speech to transcribe natural language](https://docs.oracle.com/en/solutions/ai-speech/index.html)
 
 ## LiveLabs and Workshops
 
 - [Introduction to OCI Speech](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3135&clear=RR,180&session=106771425893627)
-
+- [Search Documents stored in Object Storage using Opensearch, Generative AI, Semantic Search, RAG](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3762)
+- [Detect and manage offensive behavior in YouTube videos using OCI Data Science, OCI Language, and OCI Speech integrated with APEX](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3867&clear=RR,180&session=110244305190461)
 
 # Useful Links
 
 - [AI Solutions Hub](https://www.oracle.com/artificial-intelligence/solutions/)
-- [Oracle AI Speech on oracle.com](https://www.oracle.com/uk/artificial-intelligence/speech/)
+- [Oracle AI Speech on oracle.com](https://www.oracle.com/artificial-intelligence/speech/)
 - [Oracle AI Speech documentation](https://docs.oracle.com/en-us/iaas/Content/speech/home.htm)
 - [Oracle Speech AI service now supports diarization](https://blogs.oracle.com/ai-and-datascience/post/oracle-speech-ai-service-now-supports-diarization)
 

ai/ai-speech/README.md

@@ -5,66 +5,82 @@ The application is designed to streamline podcast production through advanced AI
 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.
 
-Reviewed: 26.11.2024
+Reviewed: 24.04.2025
+
+
+# When to use this asset?
+
+This asset is ideal for developers, content creators, marketers, educators, or any professional looking to:
+
+- **Automate podcast production**: Save time by turning written content into high-quality audio without manual recording or editing.
+- **Enhance content accessibility**: Make blog posts, newsletters, or reports more accessible by offering audio formats.
+- **Create engaging internal communications**: HR or corporate communications teams can quickly generate spoken updates for employees.
+- **Support e-learning**: Teachers or educational platforms can generate audio lessons, summaries, or storytelling content.
+- **Prototype AI-based solutions**: Developers building solutions with Oracle Cloud’s AI services can use this as a reference or starting point.
+- **Demonstrate Oracle Cloud capabilities**: This is a great demo asset for solution engineers and pre-sales teams showcasing OCI GenAI and AI Speech.
+
+Use this asset when you need a scalable, repeatable, and professional way to transform any kind of text into engaging, spoken content—quickly and efficiently.
+
+# How to use this asset?
 
-# **1. Prepare your user**
+## **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]![alt text](Podcast-md/ak1.png)
+   ![alt text]![alt text](files/Podcast-md/ak1.png)
   - Click on the Profile icon at the top-right corner and select your Profile hyperlink.
-   ![alt text](Podcast-md/ak2.png)
+   ![alt text](files/Podcast-md/ak2.png)
   - Under Resources section at the bottom-left, select API Keys and then click Add API Key.
-   ![alt text](Podcast-md/ak3.png)
+   ![alt text](files/Podcast-md/ak3.png)
   - The Add API Key dialog is displayed. Select Generate API Key Pair to create a new key pair.
-  ![alt text](Podcast-md/ak4.png)
+  ![alt text](files/Podcast-md/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](Podcast-md/ak5.png)
+  ![alt text](files/Podcast-md/ak5.png)
 
 
 
-# **2.Pick you compartment**
+## **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
+## **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](Podcast-md/import_project.jpg)
+ ![alt text](files/Podcast-md/import_project.jpg)
 
-## Configure REST APIs authentication
+### Configure REST APIs authentication
 * Open the recently created project.
 
 * Click on Services button (left side) and click on "Backends"
- ![alt text](Podcast-md/services.jpg)
+ ![alt text](files/Podcast-md/services.jpg)
 
 * Now, click on TTS, and Servers to edit server authentication.
-![alt text](Podcast-md/edit_tts.jpg)
+![alt text](files/Podcast-md/edit_tts.jpg)
 
 * Click the pencil to provide the OCI Crendentials
- ![alt text](Podcast-md/edit_tts_2.jpg)
+ ![alt text](files/Podcast-md/edit_tts_2.jpg)
 
 * Provide the crendentials you got during the step 1.
- ![alt text](Podcast-md/signature.jpg)
+ ![alt text](files/Podcast-md/signature.jpg)
 
 * Repeat the same process with the GenAI backend.
 
-## Provide your compartmentId 
+### Provide your compartmentId 
 * Provide compartmentId default value in the project variable named "comparmentid" that you got during the step 2.
- ![alt text](Podcast-md/compartmentid.jpg)
+ ![alt text](files/Podcast-md/compartmentid.jpg)
 
-#  **4.Preview the application**
+##  **4.Preview the application**
 * Now can provide a topic in the text area and click "generate" button. 
- ![alt text](Podcast-md/preview.jpg)
+ ![alt text](files/Podcast-md/preview.jpg)
 
 * Automatically a podcast script will be created and will generate the audio podcast using the Cindy and Bob voices
-  ![alt text](Podcast-md/generated.jpg)
+  ![alt text](files/Podcast-md/generated.jpg)
 
-## Notes
+### 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.

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

@@ -9,6 +9,7 @@ Oracle’s Generative AI Agents is a fully managed service that combines the pow
 - [Analysis of Structured Data and Use of AI Agents](https://luigi-saetta.medium.com/analysis-of-structured-data-and-use-of-ai-agents-a40f18da4ed5)
 - [AI Agents: The Future of Intelligent Systems in 2025](https://medium.com/@anshuman4luv/ai-agents-the-future-of-intelligent-systems-in-2025-5558c13aa328)
 - [LangChain vs LangGraph vs LangFlow vs LangSmith: A Detailed Comparison](https://medium.com/@anshuman4luv/langchain-vs-langgraph-vs-langflow-vs-langsmith-a-detailed-comparison-74bc0d7ddaa9)
+- [Developer Coaching: Unlock the power of Oracle AI](https://www.youtube.com/watch?v=6weQp8BugSg&t=2460s)
 
 ## Reusable Assets Overview
 - [HCM agent created by partner Conneqtion Group which contains agents to connect to Fusion HCM, Expense and many others](https://www.youtube.com/watch?v=OhZcWx_H_tQ)

ai/ai-speech/podcast-generator/Podcast-md/README.md renamed to ai/ai-speech/podcast-generator/files/Podcast-md/README.md

@@ -1,91 +1,80 @@
 # Assistant Secretary Agent
 
-*An AI-powered assistant that routes user input across tools like Gmail, Google Calendar, Weather API, Calculator, and Oracle’s Generative AI services for smart, dynamic task automation.*
+An AI-powered assistant that routes user input across tools like Gmail, Google Calendar, Weather API, Calculator, and Oracle’s Generative AI services for smart, dynamic task automation.
 
-Reviewed: 31.03.2025
+Reviewed: 23.04.2025
 
----
-
-## When to use this asset?
+# When to use this asset?
 
 Use this asset when you want to:
-- Automate tasks across Gmail, Calendar, and Weather
-- Get answers via OCI’s AI Agents and RAG-powered chat
-- Use a simple UI to interact with multiple tools seamlessly
-- Demo a multi-tool assistant combining local logic and cloud intelligence
+- Automate tasks across Gmail, Calendar, and Weather  
+- Get answers via OCI’s AI Agents and RAG-powered chat  
+- Use a simple UI to interact with multiple tools seamlessly  
+- Demo a multi-tool assistant combining local logic and cloud intelligence  
 
 Ideal for:
-- AI developers building assistants
-- Oracle consultants showcasing GenAI + agent capabilities
-- Technical users exploring LLM + API routing in real-world use cases
+- AI developers building assistants  
+- Showcasing GenAI + agent capabilities  
+- Technical users exploring LLM + API routing in real-world use cases  
 
----
-
-## How to use this asset?
+# How to use this asset?
 
 This assistant can be launched via:
-- **Terminal (CLI mode)**  
-- **Streamlit UI** for visual interaction
+- Terminal (CLI mode)  
+- Streamlit UI for visual interaction  
 
 It supports:
 - Reading and replying to emails  
 - Summarizing or replying smartly using GenAI  
 - Scheduling calendar events  
 - Fetching and advising based on weather  
-- Answering user queries via RAG and fallback GenAI tools
-
----
+- Answering user queries via RAG and fallback GenAI tools  
 
 ## Setup Instructions
 
-### 🔑 Google API (Gmail + Calendar)
-1. Go to **[Google Cloud Console](https://console.cloud.google.com)**
-2. Enable the **Gmail API** and **Calendar API**
-3. Create **OAuth 2.0 Credentials** and download `credentials.json`
-4. Place `credentials.json` in your project root
-5. The first time you run the assistant, a `token.json` will be created automatically
+### OCI Generative AI (Cohere on OCI)
 
----
+1. Go to OCI Console → Generative AI  
+2. Select a model like `cohere.command-r-plus-08-2024`  
+3. Copy the following values:  
+   - model_id  
+   - compartment_id  
+   - endpoint (e.g., `https://inference.generativeai.us-chicago-1.oci.oraclecloud.com`)  
+4. Paste these in `oci_models.py`  
 
-### ☁️ OCI Generative AI (Cohere on OCI)
-1. Go to **OCI Console → Generative AI**
-2. Select a model like `cohere.command-r-plus-08-2024`
-3. Copy the following values:
-   - `model_id`
-   - `compartment_id`
-   - `endpoint` (e.g., `https://inference.generativeai.us-chicago-1.oci.oraclecloud.com`)
-4. Paste these in `oci_models.py`
+[OCI GenAI Agent Guide](https://docs.oracle.com/en-us/iaas/Content/generative-ai-agents/overview.htm)
 
-🔗 [OCI GenAI Agent Guide](https://docs.oracle.com/en-us/iaas/Content/generative-ai-agents/overview.htm)
+Also create an AI Agent in OCI with a knowledge base, and upload your RAG documents into that knowledge base.
 
-Also create an **AI Agent** in OCI with a knowledge base, and upload your RAG documents into that knowledge base.
+### Google API (Gmail + Calendar)
 
----
+1. Go to [Google Cloud Console](https://console.cloud.google.com)  
+2. Enable the Gmail API and Calendar API  
+3. Create OAuth 2.0 Credentials and download `credentials.json`  
+4. Place `credentials.json` in your project root  
+5. The first time you run the assistant, a `token.json` will be created automatically  
 
-### 🌦️ Weather API
-1. Sign up at [weatherapi.com](https://www.weatherapi.com/)
-2. Get a free API key
-3. In `tools.py`, update this line with your key:
+### Weather API
+
+1. Sign up at [weatherapi.com](https://www.weatherapi.com/)  
+2. Get a free API key  
+3. In `tools.py`, update this line with your key:  
 ```python
 WEATHER_API_KEY = "your_api_key_here"
 ```
 
----
+### Start the Assistant
 
-### 💬 Start the Assistant
-
-**Terminal Mode**
+Terminal Mode:
 ```bash
 python assistant.py
 ```
 
-**Streamlit UI**
+Streamlit UI:
 ```bash
 streamlit run frontend.py
 ```
 
----
-
 ## Key Features
 
 | Tool               | Description                                                                 |
@@ -101,21 +90,17 @@ streamlit run frontend.py
 | Fallback Q&A       | Handles general questions using OCI GenAI                                  |
 | Calculator         | Parses and evaluates math queries                                           |
 
----
+## Notes
 
-## ⚠️ Notes
+- The assistant dynamically routes user queries using Cohere (hosted on OCI)  
+- Each tool is modular — easy to extend or replace  
+- Streamlit UI provides real-time visibility on tool routing  
 
-- The assistant dynamically routes user queries using Cohere (hosted on OCI)
-- Each tool is modular — easy to extend or replace
-- Streamlit UI provides real-time visibility on tool routing
-
----
-
-### 🔁 Update Email Mappings (Required)
+## Update Email Mappings (Required)
 
 To match received emails to locations (for RAG/OCI agent logic), update:
 
-**At line 397 in the code**:
+At line 397 in the code:
 ```python
 EMPLOYEE_DATA = {
     "example example <example@example.com>": "Netherlands",
@@ -124,7 +109,7 @@ EMPLOYEE_DATA = {
 }
 ```
 
-**At line 812 in the code**:
+At line 812 in the code:
 ```python
 EMPLOYEE_CITY_MAP = {
     "example example <example@example.com>": "Netherlands",
@@ -133,24 +118,28 @@ EMPLOYEE_CITY_MAP = {
 }
 ```
 
-Replace these keys with the **actual email addresses** you'll be receiving messages from.
+Replace these keys with the actual email addresses you'll be receiving messages from.
 
 ---
 
-## Useful Links
+# Useful Links (Optional)
 
-- [Oracle Generative AI Agents](https://docs.oracle.com/en-us/iaas/Content/generative-ai-agents/overview.htm)
-    - Overview of OCI's GenAI agent features
-- [Oracle Cloud Docs](https://docs.oracle.com/en/cloud/)
-    - Full documentation for OCI services
-- [Weather API](https://www.weatherapi.com/)
-    - Used for real-time weather data
+- [Oracle Generative AI Agents](https://docs.oracle.com/en-us/iaas/Content/generative-ai-agents/overview.htm)  
+  Overview of OCI's GenAI agent features  
+- [Oracle Cloud Docs](https://docs.oracle.com/en/cloud/)  
+  Full documentation for OCI services  
+- [Weather API](https://www.weatherapi.com/)  
+  Used for real-time weather data  
+- [Oracle](https://www.oracle.com)  
+  Oracle Website  
 
 ---
 
-## License
+# License
 
-Copyright (c) 2024 Oracle and/or its affiliates.
+Copyright (c) 2025 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
 
-Licensed under the Universal Permissive License (UPL), Version 1.0.  
 See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.
+