Update README.md

AlexanderHodicke · web-flow · commit 90cb1145e30f · 2024-03-15T11:03:08.000+01:00
spellchecking
diff --git a/ai-and-app-modernisation/ai-services/generative-ai-service/doc-evaluation-genai/files/README.md b/ai-and-app-modernisation/ai-services/generative-ai-service/doc-evaluation-genai/files/README.md
@@ -3,11 +3,12 @@
 Reviewed: 14.03.2024
 
 # Introduction
+
 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 tool can be super useful in different situations:
-For example, it could help recruiters in identifying the top nN% of resumes to get the best candidate for a job, as well it could help to check the RFP compliance in a vendor bid, or easily figure out what's in a bunch of email attachments without opening each one, but these are only few cases out of hundreads, you just name it. It can be applied to any industry, adaptable to any department like HR, Procurement, Marketing, Customer Service and others.
+For example, it could help recruiters in identifying the top nN% of resumes to get the best candidate for a job, as well it could help to check the RFP compliance in a vendor bid, or easily figure out what's in a bunch of email attachments without opening each one, but these are only a few cases out of hundreds, you just name it. It can be applied to any industry and is adaptable to any department like HR, Procurement, Marketing, Customer Service, and others.
 
-Here are just 2 examples on how you may use the document evaluation application :
+Here are just 2 examples of how you may use the document evaluation application:
 
 A CV Evaluation App as part of a recruitment process:
 
@@ -20,7 +21,8 @@ A Supplier Proposal Evaluation App as part of a vendor bid.
 <img src="./images/3_RFPEvaluation.png"></img>
 <img src="./images/4_RFPEvaluationResults.png"></img>
 
-In this Article we will use as a case study: **“CV Evaluation APP”**
+In this article we will use as a case study: **"CV Evaluation APP"**
+
 # Prerequisites
 
 Before getting started, make sure you have access to the following Oracle Cloud Infrastructure (OCI) services:
@@ -33,24 +35,24 @@ Before getting started, make sure you have access to the following Oracle Cloud
 
 # Solution Architecture
 
-In this section, we'll dive into the building bocks of the solution architecture.
+In this section, we'll dive into the building blocks of the solution architecture.
 <img src="./images/5_SolutionArchitecture-oci-lowcode-ai-rag-logical-blocks.png"></img>
 
-We've built the application using Oracle Visual Builder (as part of OIC), and it smoothly runs through Oracle Integration Cloud  as the main, low code orchestration tool. OCI Document Understanding is there to handle the document processing, and Generative AI Multi-Chain Prompt technique for extracting key information from these CVs, summarizing them and help to facilitate the decision making process:
+We've built the application using Oracle Visual Builder (as part of OIC), and it smoothly runs through Oracle Integration Cloud  as the main, low-code orchestration tool. OCI Document Understanding is there to handle the document processing, and Generative AI Multi-Chain Prompt technique for extracting key information from these CVs, summarizing them, and helping to facilitate the decision-making process:
 
 1. Document Evaluation Tool App interface built using VBCS:
 
 - The “CV Evaluation App” discussed in this context is crafted within the VBCS platform. Oracle Visual Builder Cloud Service serves as a hosted environment for building your application development infrastructure. It offers an open-source, standards-based development service for creating, collaborating on, and deploying applications within the Oracle Cloud. 
 
 2. Document Processing with OCI Document Understanding.:
-- The role of OCI Document Understanding is to extract content from document images and other document file types, as CVs can be in different formats..
+- The role of OCI Document Understanding is to extract content from document images and other document file types, as CVs can be in different formats.
 - The service employs machine learning and optical character recognition capabilities(OCR) to analyze and extract information from various types of documents.
 
 3. Key Criteria Extraction using OCI Generative AI Service:
-- The extracted CV data from Document Understanding is sent to the OCI Generative AI Service to perform the following two tasks: CV Summarization and evaluation criteria extraction. This action is performed via one single prompt, that we will later explore in the section “Prompting with Oracle Generative AI”.
+- The extracted CV data from Document Understanding is sent to the OCI Generative AI Service to perform the following two tasks: CV Summarization and evaluation criteria extraction. This action is performed via one single prompt, which we will later explore in the section “Prompting with Oracle Generative AI”.
 
 4. Integration and orchestration using OIC:
-- Oracle Integration Cloud adopts a low-code approach, allowing to create integrations and workflows with minimal coding effort and this accelerates the development process. OIC includes monitoring and analytics tools that provide real-time visibility into integration flows. This helps to track performance, identify bottlenecks, change and optimize LLM integration flows like the one we are exploring here.
+- Oracle Integration Cloud adopts a low-code approach, allowing the creation of integrations and workflows with minimal coding effort and this accelerates the development process. OIC includes monitoring and analytics tools that provide real-time visibility into integration flows. This helps to track performance, identify bottlenecks, and change and optimize LLM integration flows like the one we are exploring here.
 
 5. Document Evaluation using Generative AI:
 - The decision-making process could be facilitated in this case with the help of Oracle Generative AI. We are using prompting techniques to help recruiters with useful information that they can use in the decision-making process.
@@ -61,7 +63,7 @@ We've built the application using Oracle Visual Builder (as part of OIC), and it
 
 In this application:
 
-**Step1.** The File Picker action in VBCS allows the Recruiter to upload all the CVs .
+**Step1.** The File Picker action in VBCS allows the Recruiter to upload all the CVs.
 
 <img src="./images/6_Step1VBCS_FilePicker.png"></img>
 
@@ -86,7 +88,7 @@ In this application:
 <img src="./images/16_Step4OIC_DocUnderstanding.png"></img>
 
 
-**Step5.** At this step, using Generative AI the summary of the CV is created and also evaluation criteria are extracted, triggering the **OIC Query Engine Low-Code Parent Integration Flow** (CV Summary Generation and Evaluation Criteria extraction with Generative AI Inference REST API).
+**Step5.** At this step, using Generative AI the summary of the CV is created, and also evaluation criteria are extracted, triggering the **OIC Query Engine Low-Code Parent Integration Flow** (CV Summary Generation and Evaluation Criteria extraction with Generative AI Inference REST API).
 
 <img src="./images/17_Step5OIC_Summarization.png"></img>
 <img src="./images/18_Step5OIC_SummarizationProperties.png"></img>
@@ -95,25 +97,25 @@ In this application:
 <img src="./images/21_Step5OIC_SummarizationJsonDetails3.png"></img>
 <img src="./images/22_Step5OIC_GenAIPrompt.png"></img>
 
-**Step6.** Decision logic together with Evaluator Criteria and Extracted Criteria from the Candidate CV are sent to  Generative AI Inference REST API, in order to obtain one of the response “Good Fit”/ “No Fit” 
+**Step6.** Decision logic together with Evaluator Criteria and Extracted Criteria from the Candidate CV are sent to  Generative AI Inference REST API, to obtain one of the responses “Good Fit”/ “No Fit” 
 
 <img src="./images/23_Step6OIC_Evaluation.png"></img>
 <img src="./images/24_Step6OIC_GenAIPrompt.png"></img>
 
-**Step7.** The list of all candidates is shown on the screen together with the response if the canditate is a good fit or not. Also a summary of each CV is available.
+**Step7.** The list of all candidates is shown on the screen together with the response if the candidate is a good fit or not. Also, a summary of each CV is available.
 
 <img src="./images/25_Step6OIC_VBCSEvaluationResult.png"></img>
 
 # Prompting with Oracle Generative AI
 
-In the following CV Evaluation APP usecase we are using a Generative AI Multi-Chain Prompting technique in order to get the results. It consists of 2 prompts:
+In the following CV Evaluation APP use case we are using a Generative AI Multi-Chain Prompting technique to get the results. It consists of 2 prompts:
 
 **Important Note:** 
 **All examples and data presented in this article are purely fictive and for showcasing purposes only. Any resemblance to real persons, or actual companies is purely coincidental. Dummy users and entities have been created for this demo, and no real data or information about individuals or organizations is being disclosed. We prioritize privacy and ethical considerations in the presentation of information, and any similarities to real-world entities are unintentional.**
 
-## Prompt 1: Summarization and Key Criteria extraction
+## Prompt 1: Summarization and Key Criteria Extraction
 
-In order to extract the right skills from the CV that matches the Evaluator input, we have created a prompt in a Zero-shot technique, where we explicity mentioning the output we need to gather out of the document:
+To extract the right skills from the CV that match the Evaluator input, we have created a prompt in a Zero-shot technique, where we explicitly mention the output we need to gather out of the document:
 
 
 <img src="./images/22_Step5OIC_GenAIPrompt.png"></img>
@@ -122,7 +124,7 @@ Please access the full prompt <a href="./images/CVEvaluationAppPrompts.pdf">here
 
 ## Prompt 2: Final candidate skills evaluation
 
-In order to evaluate all the CVs, a single prompt was build using two combined techniques: **Few-shot Prompting** and **Chain-of-Thought Prompting**.
+To evaluate all the CVs, a single prompt was built using two combined techniques: **Few-shot Prompting** and **Chain-of-Thought Prompting**.
 
 <img src="./images/24_Step6OIC_GenAIPrompt.png"></img>
 
@@ -139,7 +141,7 @@ Please find the **document_evaluation_app_resources.zip** archive in <a href="./
 
 # Conclusion
 
-In conclusion,  using Oracle Generative AI, OCI Document Understanding, and Oracle Integration Cloud (OIC)  you may built a nice solution that may  sort and help in evaluating documents across various industries and departments. It's adaptability and ease of use can become a handy tool for streamlining document management processes, saving time, and helping in enhancing productivity across a wide range of business scenarios.
+In conclusion,  using Oracle Generative AI, OCI Document Understanding, and Oracle Integration Cloud (OIC)  you may build a nice solution that may  sort and help in evaluating documents across various industries and departments. Its adaptability and ease of use can become a handy tool for streamlining document management processes, saving time, and helping enhance productivity across a wide range of business scenarios.
 
 ### Authors
 
