diff --git a/ai/oracle-digital-assistant/README.md b/ai/oracle-digital-assistant/README.md index df8e2562b..30317cb2c 100644 --- a/ai/oracle-digital-assistant/README.md +++ b/ai/oracle-digital-assistant/README.md @@ -18,6 +18,21 @@ Reviewed: 21.08.2025 - [ODA Pro styled](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/oracle-digital-assistant/oda-pro-styled) - A customizable chat interface for ODA +- [ODA Concierge Template](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/oracle-digital-assistant/templates/concierge-template) + - An easy to use Q&A template for ODA + +- [ODA Concierge+Agent Template](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/oracle-digital-assistant/templates/concierge-agent-template) + - An easy to use Q&A with Agent template for ODA + +- [ODA HCM Template](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/oracle-digital-assistant/templates/hcm-ml) + - Multilingual HCM template to combine with Fusion HCM skill + +- [ODA AI Services](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/oracle-digital-assistant/templates/ai-services) + - Template skill to consume AI Services speech/vision/document/language + +- [ODA AI Agent with doc-groups](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/oracle-digital-assistant/templates/agent-doc-groups) + - Template skill to use AI Agent with different document groups + ## Cloud Coaching & Live Labs - [Cloud Coaching - Art of the possible Digital Assistant](https://www.youtube.com/watch?v=zPmfjuYQCGg&t=49s) diff --git a/ai/oracle-digital-assistant/templates/agent-doc-groups/LICENSE b/ai/oracle-digital-assistant/templates/agent-doc-groups/LICENSE new file mode 100644 index 000000000..2685138fc --- /dev/null +++ b/ai/oracle-digital-assistant/templates/agent-doc-groups/LICENSE @@ -0,0 +1,35 @@ +Copyright (c) 2025 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. \ No newline at end of file diff --git a/ai/oracle-digital-assistant/templates/agent-doc-groups/README.md b/ai/oracle-digital-assistant/templates/agent-doc-groups/README.md new file mode 100644 index 000000000..c12f08eb3 --- /dev/null +++ b/ai/oracle-digital-assistant/templates/agent-doc-groups/README.md @@ -0,0 +1,27 @@ +# Oracle Digital Assistant AI Agent with document groups + +This template is an ODA-skill for using AI Agent with different document-groups. +This limits AI Agent to only use a specific group of documents when answering a prompt +There are several scenario's with ODA how this can be used: +- Limit a skill to a certain subject +- Define document groups per intent/flow +- Define document groups based on users role + +Reviewed: 31.10.2025 + +Setup: + Import the mdAgent1 skill in ODA + In the skill configuration you can define one or more document groups + In the sample flow you can pass the document group in the API call + In AI Agent you have to define document groups by: + [adding meta-data when uploading docs](https://docs.oracle.com/en-us/iaas/Content/generative-ai-agents/RAG-tool-object-storage-guidelines.htm#add-metadata-header) + set metaData type in _all.metadata.json in the root of your object storage bucket + (re)run ingestion job in Knowledge bases + +# License + +Copyright (c) 2025 Oracle and/or its affiliates. + +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. diff --git a/ai/oracle-digital-assistant/templates/agent-doc-groups/files/_all.metadata.json b/ai/oracle-digital-assistant/templates/agent-doc-groups/files/_all.metadata.json new file mode 100644 index 000000000..05fca0f1c --- /dev/null +++ b/ai/oracle-digital-assistant/templates/agent-doc-groups/files/_all.metadata.json @@ -0,0 +1,22 @@ +{ + "HR-general.pdf": { + "metadataAttributes": { + "type": "HCM" + } + }, + "ITsupport.pdf": { + "metadataAttributes": { + "type": "ICT" + } + }, + "expenses.pdf": { + "metadataAttributes": { + "type": "HCM" + } + }, + "SALES/revrec.pdf": { + "metadataAttributes": { + "type": "SALES" + } + } +} \ No newline at end of file diff --git a/ai/oracle-digital-assistant/templates/agent-doc-groups/files/mdAgent1(1.0).zip b/ai/oracle-digital-assistant/templates/agent-doc-groups/files/mdAgent1(1.0).zip new file mode 100644 index 000000000..d020e25ae Binary files /dev/null and b/ai/oracle-digital-assistant/templates/agent-doc-groups/files/mdAgent1(1.0).zip differ diff --git a/ai/oracle-digital-assistant/templates/ai-services/LICENSE b/ai/oracle-digital-assistant/templates/ai-services/LICENSE new file mode 100644 index 000000000..2685138fc --- /dev/null +++ b/ai/oracle-digital-assistant/templates/ai-services/LICENSE @@ -0,0 +1,35 @@ +Copyright (c) 2025 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. \ No newline at end of file diff --git a/ai/oracle-digital-assistant/templates/ai-services/README.md b/ai/oracle-digital-assistant/templates/ai-services/README.md new file mode 100644 index 000000000..d02e5c786 --- /dev/null +++ b/ai/oracle-digital-assistant/templates/ai-services/README.md @@ -0,0 +1,18 @@ +# Oracle Digital Assistant AI Services Template + +This template is a skill for quickly setting up using AI Vision, AI Document Understanding, AI Language and AI speech integration from ODA + +Reviewed: 31.10.2025 + +Setup: + Import the mdAI_services skill in ODA + For each of the services a flow is defined to connect to one of the AI Services + Make sure you change connection to your AI Service instances + +# License + +Copyright (c) 2025 Oracle and/or its affiliates. + +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. diff --git a/ai/oracle-digital-assistant/templates/ai-services/files/mdAI_services(1.0).zip b/ai/oracle-digital-assistant/templates/ai-services/files/mdAI_services(1.0).zip new file mode 100644 index 000000000..fae1a4961 Binary files /dev/null and b/ai/oracle-digital-assistant/templates/ai-services/files/mdAI_services(1.0).zip differ diff --git a/ai/oracle-digital-assistant/templates/concierge-agent-template/LICENSE b/ai/oracle-digital-assistant/templates/concierge-agent-template/LICENSE new file mode 100644 index 000000000..2685138fc --- /dev/null +++ b/ai/oracle-digital-assistant/templates/concierge-agent-template/LICENSE @@ -0,0 +1,35 @@ +Copyright (c) 2025 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. \ No newline at end of file diff --git a/ai/oracle-digital-assistant/templates/concierge-agent-template/README.md b/ai/oracle-digital-assistant/templates/concierge-agent-template/README.md new file mode 100644 index 000000000..09aa6398a --- /dev/null +++ b/ai/oracle-digital-assistant/templates/concierge-agent-template/README.md @@ -0,0 +1,20 @@ +# Oracle Digital Assistant Concierge with Agent Template + +This template is a skill for quickly setting up a Knowledge bot and using AI Agent for anything no answer was found. + +Reviewed: 31.10.2025 + +Concierge-Agent Template WebSDK +Import the mdAgentConcierge in ODA to include Agent whenever no matching answer intent was found + +Setup: + First setup the Concierge template as described [here](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/oracle-digital-assistant/templates/concierge-template) + Next import the mdAgentConcierge in ODA to include Agent whenever no matching answer intent was found + +# License + +Copyright (c) 2025 Oracle and/or its affiliates. + +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. diff --git a/ai/oracle-digital-assistant/templates/concierge-agent-template/files/mdAgentConcierge(24.10).zip b/ai/oracle-digital-assistant/templates/concierge-agent-template/files/mdAgentConcierge(24.10).zip new file mode 100644 index 000000000..cc619f36f Binary files /dev/null and b/ai/oracle-digital-assistant/templates/concierge-agent-template/files/mdAgentConcierge(24.10).zip differ diff --git a/ai/oracle-digital-assistant/templates/concierge-template/README.md b/ai/oracle-digital-assistant/templates/concierge-template/README.md index abb023530..e0722e3e5 100644 --- a/ai/oracle-digital-assistant/templates/concierge-template/README.md +++ b/ai/oracle-digital-assistant/templates/concierge-template/README.md @@ -2,7 +2,7 @@ The Concierge Template is a skill for quickly setting up a Knowledge bot. -Reviewed: 22.09.2025 +Reviewed: 31.10.2025 Concierge Template WebSDK diff --git a/ai/oracle-digital-assistant/templates/concierge-template/files/mdAgentConcierge(24.10).zip b/ai/oracle-digital-assistant/templates/concierge-template/files/mdAgentConcierge(24.10).zip new file mode 100644 index 000000000..cc619f36f Binary files /dev/null and b/ai/oracle-digital-assistant/templates/concierge-template/files/mdAgentConcierge(24.10).zip differ