diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/build.md b/dev-ai-app-dev-constructioneng-aiexperience/build/build.md index 9986b02e6..8a9258290 100644 --- a/dev-ai-app-dev-constructioneng-aiexperience/build/build.md +++ b/dev-ai-app-dev-constructioneng-aiexperience/build/build.md @@ -46,7 +46,9 @@ This lab assumes you have: ## Task 3: View created tables in Jupyter Lab -1. Navigate back to your terminal window. +1. Stay in JupyterLab. The file browser remains available while the + Launcher is open, so you do not need to return to the Terminal or + close the Launcher tab. ![Open Terminal](./images/terminal.png " ") @@ -61,9 +63,14 @@ This lab assumes you have: ![Tables](./images/tables.png " ") +3. After reviewing the setup script, close the + `db_setup_CONSTENG_script_2.sql` tab. You will continue the rest of + the lab from the Launcher and your notebook, so the script tab is + no longer needed. + ## Task 4: Connect to Database -1. Click the **+** sign on the top left to open the Launcher. +1. Return to the existing Launcher tab. ![Open Launcher](./images/open-launcher.png " ") @@ -138,7 +145,7 @@ In this task, you will: project details, sourcing requirements, risk level, recommended supplier, supplier fit score, and evaluation status. -1. Copy and paste the code below into the new notebook. +1. Copy and paste the code below into a new cell in your notebook. ```python @@ -629,7 +636,7 @@ This step: `CE_PROJECT_CHUNKS` table so the chunks can be searched by semantic similarity in the next task. -1. Run and review the code in a new cell: +1. Copy the following code into a new cell. ```python @@ -705,7 +712,9 @@ This step: use only supplier names that appear in the provided records or context. -1. Copy the code block below to implement RAG: +1. The following code block will perform + Retrieval-Augmented Generation (RAG). Copy this code block into a + new cell. ```python @@ -850,7 +859,10 @@ Tasks: 2. Click the **Run** button to execute the cell. The notebook will process the question using AI Vector Search, retrieve the most relevant chunks from the `CE_PROJECT_CHUNKS` table, and send the - retrieved context to OCI Generative AI. + retrieved context to OCI Generative AI. OCI Generative AI then + uses the retrieved project and supplier evidence to generate a + grounded response that summarizes the best-fit supplier and the + reasoning behind that recommendation. ![ask question](./images/task7.png " ") @@ -898,4 +910,4 @@ Congratulations, you completed the lab. ## Acknowledgements * **Authors** - Francis Regalado -* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniet Hart, July 2026 +* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniel Hart, July 2026 diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter-login.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter-login.png index 1834d777e..d2a99691b 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter-login.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter-login.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter.png index 76466e3d0..316eb6f52 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/jupyter.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task1.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task1.png index 197d91e68..a04e70dde 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task1.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task1.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task3.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task3.png index 540b60df7..087f20e4e 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task3.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task3.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task4.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task4.png index 1a744b16e..d763788e9 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task4.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/lab4task4.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/launcher.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/launcher.png index 5be0ce713..b5d18ecab 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/launcher.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/launcher.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-launcher.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-launcher.png index cc5c04cdc..316eb6f52 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-launcher.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-launcher.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-notebook.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-notebook.png index e3704ea3f..b5d18ecab 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-notebook.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/open-notebook.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/tables.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/tables.png index 86c4dcd19..18637fa8d 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/tables.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/tables.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task4recommendations.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task4recommendations.png index e29066d5b..1fc4c41a0 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task4recommendations.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task4recommendations.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task5.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task5.png index afac6204c..3846cd13a 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task5.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task5.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7.png index 23fef08e9..117ac4e1b 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7recs.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7recs.png index 0b0bbffee..6a13594e2 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7recs.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7recs.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7results.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7results.png index fd8364c13..0d5686fc6 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7results.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task7results.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task8.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task8.png index 15f05a377..f2de84758 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/task8.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/task8.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/build/images/terminal.png b/dev-ai-app-dev-constructioneng-aiexperience/build/images/terminal.png index 39bdf7819..316eb6f52 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/build/images/terminal.png and b/dev-ai-app-dev-constructioneng-aiexperience/build/images/terminal.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/introduction/images/architecture.png b/dev-ai-app-dev-constructioneng-aiexperience/introduction/images/architecture.png new file mode 100644 index 000000000..f765566ad Binary files /dev/null and b/dev-ai-app-dev-constructioneng-aiexperience/introduction/images/architecture.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/introduction/introduction.md b/dev-ai-app-dev-constructioneng-aiexperience/introduction/introduction.md index b9f38f040..9e00a88cd 100644 --- a/dev-ai-app-dev-constructioneng-aiexperience/introduction/introduction.md +++ b/dev-ai-app-dev-constructioneng-aiexperience/introduction/introduction.md @@ -55,10 +55,23 @@ This workshop assumes you have: * Basic knowledge of Python. * Basic knowledge of Oracle Database, including how to run queries. +### Architecture + +Below is a visual representation of the lab workflow. As a **Construction Procurement Officer**, you will review supplier submissions for construction engineering projects. **Oracle AI Database** converts your question or the project details you are reviewing into a **vector embedding**, then uses **semantic search** to find relevant information based on meaning rather than exact keyword matches. The most relevant document excerpts are provided to the AI along with your question. Using this evidence, the AI delivers a **grounded recommendation** to approve, deny, or request more information, with a clear rationale. + +![Diagram](./images/architecture.png =50%x*) + +The application utilizes key features of Oracle AI Database: + +* **Converged Database:** keeps transactional, analytical, AI, and operational data together. +* **AI Vector Search:** enables semantic “meaning-based” search across documents and project data. +* **JSON Duality Views / JSON Transform:** makes document-style JSON data easier to use alongside relational tables. +* **Property Graph:** models relationships—for example, which supplier supports which project, requirement, risk, or evaluation. + ## Learn More * [Oracle AI Database Documentation](https://docs.oracle.com/en/database/oracle/oracle-database/23/) ## Acknowledgements * **Authors** - Uma Kumar -* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniet Hart, July 2026 +* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniel Hart, July 2026 diff --git a/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/homepage.png b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/homepage.png new file mode 100644 index 000000000..150921b03 Binary files /dev/null and b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/homepage.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/keeppdf.png b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/keeppdf.png new file mode 100644 index 000000000..2970bcfdc Binary files /dev/null and b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/keeppdf.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/keeppdf2.png b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/keeppdf2.png new file mode 100644 index 000000000..abb11efd6 Binary files /dev/null and b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/keeppdf2.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/p1001-final-approved.png b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/p1001-final-approved.png index 068c2a8b3..63f0d1a43 100644 Binary files a/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/p1001-final-approved.png and b/dev-ai-app-dev-constructioneng-aiexperience/user-story/images/p1001-final-approved.png differ diff --git a/dev-ai-app-dev-constructioneng-aiexperience/user-story/user-story.md b/dev-ai-app-dev-constructioneng-aiexperience/user-story/user-story.md index f2c14c6eb..12fdc53c6 100644 --- a/dev-ai-app-dev-constructioneng-aiexperience/user-story/user-story.md +++ b/dev-ai-app-dev-constructioneng-aiexperience/user-story/user-story.md @@ -46,6 +46,8 @@ In this first example, you will review and approve a low-risk project. The first 2. The **Downtown Mixed-Use Tower** project page opens with a project snapshot showing key procurement details, including project ID, project name, location, project phase, required trade, procurement urgency, budget range, and risk level. Below the snapshot, review the **Project Analysis Powered by AI** section. For this project, the overall risk score is low, and the analysis summarizes the project requirements, sourcing needs, and documentation signals used to support an approval recommendation. + >💡 **Note**: AI analysis may take a few seconds to complete. Please wait for the output to appear. + ![P1001 AI generated recommendations](./images/p1001-ai.png =50%x*) 3. At the bottom of the **Downtown Mixed-Use Tower** evaluation, you will find the **AI Procurement Guru**, a chatbot powered by **Oracle AI Database AI Vector Search and OCI Generative AI**. @@ -94,15 +96,19 @@ In this first example, you will review and approve a low-risk project. The first ![P1001 PDF](./images/p1001-openpdf.png =50%x*) -10. Open the downloaded PDF to review the **Final Decision Notice**. This document summarizes the approved decision for **Downtown Mixed-Use Tower**, including the selected supplier, risk score, approval rationale, and next steps. +10. You may get a notification that the file being downloaded is insecure. Click **Keep** to download the file. + + ![Keep PDF](./images/keeppdf.png =50%x*) + +11. Open the downloaded PDF to review the **Final Decision Notice**. This document summarizes the approved decision for **Downtown Mixed-Use Tower**, including the selected supplier, risk score, approval rationale, and next steps. ![P1001 PDF](./images/p1001-pdfv2.png =50%x*) -11. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**. +12. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**. ![Return to Dashboard](./images/p1001-dashboard.png =50%x*) -12. Expand **View Approved Projects**. Confirm that project `1001`, **Downtown Mixed-Use Tower**, no longer appears in the **Pending Projects** list and now appears in the **Approved Projects** list with the status **Approved**. +13. Expand **View Approved Projects**. Confirm that project `1001`, **Downtown Mixed-Use Tower**, no longer appears in the **Pending Projects** list and now appears in the **Approved Projects** list with the status **Approved**. ![Approved List](./images/p1001-final-approved.png =50%x*) @@ -119,7 +125,7 @@ Once you select and save one of the AI-recommended supplier options: Congratulations, you have just approved your first project. Proceed to the next task. -## Task 3: Demo - Project with High risk level +## Task 3: Demo - Project with High Risk Level In this example, you will review a high-risk project and deny it as part of the exercise. The second project on your list is project `1003`, **Harbor Seismic Retrofit**. 1. On the **Supplier Evaluation Dashboard**, go to the **Pending Projects** list. In the row for project `1003`, **Harbor Seismic Retrofit**, click **Review** to open the project details. @@ -129,6 +135,8 @@ In this example, you will review a high-risk project and deny it as part of the 2. The **Harbor Seismic Retrofit** project profile opens with a project snapshot showing key procurement details, including project ID, location, project phase, required trade, procurement urgency, budget range, risk level, and evaluation status. Below the snapshot, review the **Project Analysis Powered by AI** section. For this scenario, the project has an overall risk score of **9/10**, marked as **High Risk**. The AI analysis evaluates the project requirements and supplier evidence, then recommends a denial or new RFP if core requirements are not met. It also provides guidance on the risk factors that would need to be addressed before the project could move forward. + >💡 **Note**: AI analysis may take a few seconds to complete. Please wait for the output to appear. + ![Harbor Seismic Retrofit AI generated recommendations](./images/p1003-profile.png =50%x*) 3. Click **Navigate to Project Decisions**. Before reviewing the decision page, consider the AI analysis shown above: why is the system recommending denial or a new RFP for **Harbor Seismic Retrofit**? @@ -163,15 +171,19 @@ In this example, you will review a high-risk project and deny it as part of the ![P1003 Download Recommendation](./images/p1003-download2.png =50%x*) -8. Open the downloaded PDF and review the **Final Decision Notice** for **Harbor Seismic Retrofit**. The document summarizes the denied decision and provides next steps, such as submitting a new RFP for qualified seismic steel suppliers that meet the project’s compliance requirements. +8. You may get a notification that the file being downloaded is insecure. Click **Keep** to download the file. + + ![Keep PDF](./images/keeppdf2.png =50%x*) + +9. Open the downloaded PDF and review the **Final Decision Notice** for **Harbor Seismic Retrofit**. The document summarizes the denied decision and provides next steps, such as submitting a new RFP for qualified seismic steel suppliers that meet the project’s compliance requirements. ![Open P1003 PDF](./images/p1003-pdf.png =50%x*) -9. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**. +10. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**. ![Return to Dashboard](./images/p1003-dashboard.png =50%x*) -10. Expand **View Denied Projects**. Confirm that project `1003`, **Harbor Seismic Retrofit**, no longer appears in the **Pending Projects** list and now appears in the **Denied Projects** section with the status **Denied**. +11. Expand **View Denied Projects**. Confirm that project `1003`, **Harbor Seismic Retrofit**, no longer appears in the **Pending Projects** list and now appears in the **Denied Projects** section with the status **Denied**. ![Denied List](./images/p1003-denied.png =50%x*) @@ -212,6 +224,9 @@ This demonstrates how the app can apply updates to the project profile while kee ![Project Profile Updated](./images/p1004-uploadedpdf2.png) +5. Click **Return to Dashboard** to return to the home page of the application. + + ![return to dashboard](./images/homepage.png =50%x*) **Conclusion**: @@ -254,4 +269,4 @@ By combining these Oracle AI Database capabilities, the application helps stream ## Acknowledgements * **Authors** - Linda Foinding, Francis Regalado * **Contributors** - Eddie Ambler, Ramona Magadan, Mark Nelson, Andy Tael, Anders Swanson, Rahul Tasker -* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniet Hart, July 2026 +* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniel Hart, July 2026