From 1ecef17d736cdb7889627c6bbbec88e081c8d695 Mon Sep 17 00:00:00 2001 From: Apoorva Srinivas Date: Sat, 17 Aug 2024 05:10:46 +0530 Subject: [PATCH] wms: 11628 - New manifest for OCW24 (#184) * ocw manifest files * Added Movies-Lab workshop files * ocw manifest files * 22.1 updates to Spreadsheet Lab * 22.1 updates * Update 1-sign-up-apex.md * Updated absolute urls * updated the common urls * updated the urls * Added a NOTE to indicate version difference * updated path for Lab 4 * Updated the paths * Updated the Workshop Title * Update screenshot in Task 2 Step 7 * Added alt text to images * URLS updated in index.html * Updated the steps for Option 2: Sign up for APEX using ADB * alt text for images * Shopping App 22.1 updates * 22.1 updates * archiving Shopping Cart 21.2 * Updated manifest files for OCW * Feedback updated for 22.1 * Updated the PL/SQL code for checkout * Update process-properties.png * Feedback update 22.1 * Hid the old walkthrough videos * Alt text for all images * Delete clothing-images.zip * Updated steps for Livelabs Green Button * Changes to steps for Livelabs Green button * Fixed the comments wrt PR * Updated screenshots in Common * OCW updates to optional labs * Updated filename in manifest for optional lab * OCI console Redwood theme screenshots Replacement of screenshots as per the new Redwood theme for OCI console * Resolved issue in APEX 22.2 for Task 5 Added an additional step to set the source for Region in Task 5. * Update manifest.json Lab 4 was pointing to an invalid lab. I have updated it to the correct folder path. * First Draft for New Workshop All the files related to the Social Media Workshop * Issue fix * Issue fixes * Issue Fix * issue-fix * removed lab 10 * screenshot fix * Replaced Screenshots * Updated screenshots * Replaced Screenshots * Updated Screenshots * Create menu-button.png * Issue fixes and time saver step * Lab 10 steps added * Fixed issues * Renamed Lab titles * Added Task 3 and 4 in Lab 8 * Updated screenshots * uploaded the catch up app * Update 0-introduction.md * Completed app zip files * Added download links from Object Storage * ocw23 folders * 23.1 changes * updated acknowledgements * Archive of 22.1 * Updated Movies and common * Updated APEX version in Intro * Feedback fixes * Grammar edits * Sign up for APEX using Quickstart * Updated Lab 10 Added missing steps to get device location * Added the support lab Added CloudWorld support labs for Movies Watchlist and Social Media Workshop * Updated Getting Started Common Lab Changed the steps to sign up for an APEX Service * Updated missing steps * Changed the title of Spreadsheet workshop * Embedded walkthrough videos Social Media Workshop * Grammar edits * Updated Need Help for OCW * Update 4-Update-table.md * Rename 4-Update-table.md to 4-update-table.md * Delete task-definition.md * Update 4-update-table.md * Fixing bugs * Added video walkthrough files * Update intro.md * Update manifest.json * Updated screenshots in Common * APEX 23.2 updates to Spreadsheet Updates to Spreadsheet and Common Lab * Naming issues fixed * Update 1-sign-up-apex.md * Fixed naming, prereq, obj * Naming issues fixed * Issue fixes in common lab * Changes in common and delete unwanted files * Removed duplicate folders * Updated all labs to 23.2 * Fixed the Manifest file errors * Updated steps and text related to a bug * New Lab added * Update 5-improve-ux.md * Update manifest.json * Update 5-improve-ux.md * fixed issues for new lab * Update introduction.md * Updated to latest files * renamed the images * Fixed issues and feedback * Title and text changes * Improve text and screenshots * Improve text * Fixed bugs * Fix Grammar and issues * Updated common lab * Update 1-sign-up-apex.md * Update introduction.md * updated par url * Update introduction.md * Update introduction.md * Update introduction.md * Grammar changes * 11628 - New Workshop * wms: 11628 -Lab 3 and Lab 4 * wms: 11628 - Lab 5 * Create nyc_high_schools.xlsx * Feedback fixes * Grammar edits * issue fixes * issue fix * common lab * Update 0-intro.md * Update 0-intro.md * typo fixes * grammar fixes * self-qa check * Grammar fixes to Title * Update 3-using-genai.md * Feedback fixes * Typo Fix * Issue fixes. * Bug fixes * Screenshot fixes * Screenshot mismatch fixed * PAR URL update * Changes in implementation to OCI Gen AI * Update oci-gen-ai-details.png * Update 0-intro.md * issue fix * Modify instructions for Download * Update 3-configure-oci.md * Update 0-intro.md * prerequisites * feedback fixes * sandbox manifest * sandbox manifest * Typo fix * oci genai Model name change * PAR url has changed * manifest for ocw * updates for ocw24 --------- Co-authored-by: Michelle Malcher <48925485+malcherm@users.noreply.github.com> Co-authored-by: Anoosha Pilli <63126232+anooshapilli@users.noreply.github.com> Co-authored-by: Hope Fisher <127253314+hope-fisher@users.noreply.github.com> Co-authored-by: Dan Wiliams <127415766+dannymgithub@users.noreply.github.com> --- .../3-configure-oci/3-configure-oci-ocw24.md | 76 +++++++++++++++++++ nyc-genai-lab/workshops/ocw24/index.html | 62 +++++++++++++++ nyc-genai-lab/workshops/ocw24/manifest.json | 53 +++++++++++++ 3 files changed, 191 insertions(+) create mode 100644 nyc-genai-lab/3-configure-oci/3-configure-oci-ocw24.md create mode 100644 nyc-genai-lab/workshops/ocw24/index.html create mode 100644 nyc-genai-lab/workshops/ocw24/manifest.json diff --git a/nyc-genai-lab/3-configure-oci/3-configure-oci-ocw24.md b/nyc-genai-lab/3-configure-oci/3-configure-oci-ocw24.md new file mode 100644 index 00000000..91d12428 --- /dev/null +++ b/nyc-genai-lab/3-configure-oci/3-configure-oci-ocw24.md @@ -0,0 +1,76 @@ +# Create the Web Credentials + +## Introduction + +In this workshop, you use OCI Generative AI as the AI provider to build a conversational chatbot. To use the OCI Generative AI Service in APEX, you will use the keys provided in the lab [Your OCI GenAI key](?lab=tut3253). + +Note: OCI Generative AI service is available in limited regions. If you are using your own cloud tenancy, check to see if your cloud region supports OCI Generative AI service, visit the [documentation](https://docs.oracle.com/en-us/iaas/Content/generative-ai/overview.htm#regions). + +Estimated Time: 10 Minutes + +### Objectives +In this lab, you: + +- Create Web Credentials in Oracle APEX + +## Prerequisites +- Download the zip file from [Your OCI GenAI key](?lab=tut3253) + +## Task 1: Create Web Credentials in Oracle APEX + +Web credentials are used to authenticate connection to external REST services, or REST Enabled SQL services from APEX. + +Creating Web Credentials securely stores and encrypts authentication credentials for use by Oracle APEX components and APIs. Credentials cannot be retrieved back in clear text. Credentials are stored at the workspace level and therefore are visible to all applications. + +To create a Web Credential in Oracle APEX: + +1. Login into your Oracle APEX workspace. + + ![Login into your APEX account](images/apex-login.png " ") + +2. On the Workspace home page, click **App Builder**. + + ![Click App Builder](images/app-builder1.png " ") + +3. Click **Workspace Utilities**. + + ![Click Workspace Utilities](images/workspace-utilities.png " ") + +4. Select **Web Credentials**. + + ![Click Web Credentials](images/sc-web-creds.png " ") + +5. Click **Create**. + + ![Create Web Credentials](images/create-wc.png " ") + +6. Enter the following details using the configuration file you copied in the previous task. + + - **Name**: apex\_ai\_cred + + - **Authentication Type**: OCI Native Authentication + + - **OCI User ID**: Enter the OCID of the Oracle Cloud user Account. You can find the OCID in the zip folder you downloaded as part os prerequisites. + Your OCI User ID looks similar to **ocid1.user.oc1..aaaaaaaa\*\*\*\*\*\*wj3v23yla** + + - **OCI Private Key**: Open the private key (.pem file) downloaded in the previous task. Copy and paste the API Key. + + ![Private key file](images/private-key.png " ") + + - **OCI Tenancy ID**: Enter the OCID for Tenancy. Your Tenancy ID looks similar to **ocid1.tenancy.oc1..aaaaaaaaf7ush\*\*\*\*cxx3qka** + + - **OCI Public Key Fingerprint**: Enter the Fingerprint ID. Your Fingerprint ID looks similar to **a8:8e:c2:8b:fe:\*\*\*\*:ff:4d:40** + + ![Web Credentials page](images/web-creds.png " ") + +5. Click **Create**. + +## Summary + +You now know how to create web credentials in Oracle APEX. + +You may now **proceed to the next lab**. + +## Acknowledgments +- **Author** - Apoorva Srinivas, Senior Product Manager +- **Last Updated By/Date** - Apoorva Srinivas, Senior Product Manager, August 2024 diff --git a/nyc-genai-lab/workshops/ocw24/index.html b/nyc-genai-lab/workshops/ocw24/index.html new file mode 100644 index 00000000..aaac634b --- /dev/null +++ b/nyc-genai-lab/workshops/ocw24/index.html @@ -0,0 +1,62 @@ + + + + + + + + + Oracle LiveLabs + + + + + + + + + + + + +
+
+
+
+
+
+
+
+ + + + + diff --git a/nyc-genai-lab/workshops/ocw24/manifest.json b/nyc-genai-lab/workshops/ocw24/manifest.json new file mode 100644 index 00000000..e679ded0 --- /dev/null +++ b/nyc-genai-lab/workshops/ocw24/manifest.json @@ -0,0 +1,53 @@ +{ + "workshoptitle": "Build an Innovative Q&A Interface Powered by Generative AI with Oracle APEX", + "help": "livelabs-help-apex_us@oracle.com", + "tutorials": [ + { + "title": "Introduction", + "filename": "../../0-intro/0-intro.md" + }, + { + "title": "Get Started", + "description": "Prerequisites for LiveLabs (Oracle-owned tenancies). The title of the lab and the Contents Menu title (the title above) match for Prerequisite lab. This lab is always first.", + "filename": "https://oracle-livelabs.github.io/common/labs/cloud-login/cloud-login-livelabs2.md" + }, + { + "title": "Sign up for an APEX Workspace", + "filename": "../../../common-241/1-sign-up-apex/sign-up-apex-sandbox.md" + }, + { + "title": "Your OCI GenAI key", + "filename": "https://oracle-livelabs.github.io/common/labs/ocw24/tut3253.md" + }, + { + "title": "Lab 1: Create an APEX App", + "filename": "../../1-create-app/1-create-app.md" + }, + { + "title": "Lab 2: Visualize Schools on a Map", + "filename": "../../2-schools-on-map/2-schools-on-map.md" + }, + + { + "title": "Lab 3: Create the Web Credentials", + "filename": "../../3-configure-oci/3-configure-oci-ocw24.md" + }, + { + "title": "Lab 4: Build a Conversational Inquiry using Generative AI", + "filename": "../../4-using-genai/4-using-genai.md" + }, + { + "title": "Lab 5: Generate Email to Apply to a School using Gen AI", + "filename": "../../5-apply-to-school/5-apply-to-school.md" + }, + { + "title": "Lab 6: Run the Application", + "filename": "../../6-run-app/6-run-app.md" + }, + { + "title": "Need Help?", + "description": "Solutions to Common Problems and Directions for Receiving Live Help", + "filename":"https://oracle-livelabs.github.io/common/labs/need-help/need-help-livelabs.md" + } + ] +}