diff --git a/data-platform/data-science/oracle-ai-agent-memory/README.md b/data-platform/data-science/oracle-ai-agent-memory/README.md index fea7b4082..c0d7c4428 100644 --- a/data-platform/data-science/oracle-ai-agent-memory/README.md +++ b/data-platform/data-science/oracle-ai-agent-memory/README.md @@ -24,7 +24,7 @@ Reviewed: 2026.04.23 # Team Publications -- Coming Soon +- [Oracle AI Agent Memory - Tracking Engagements Over Time](https://medium.com/@harrysnart/exploring-oracle-agent-memory-32ef77ef178f?postPublishedType=initial)

diff --git a/data-platform/data-science/oracle-select-ai/select-ai-intro-nl2sql/LICENSE b/data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/LICENSE similarity index 100% rename from data-platform/data-science/oracle-select-ai/select-ai-intro-nl2sql/LICENSE rename to data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/LICENSE diff --git a/data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/README.md b/data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/README.md new file mode 100644 index 000000000..5e4b3bbe1 --- /dev/null +++ b/data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/README.md @@ -0,0 +1,27 @@ +# Select AI Getting Started - Setup Guide + +Use this asset as a reference for setting up the pre-requisites required to start utilising the Select AI capabilities available within the Oracle AI Database. + +Reviewed: 2026.04.30 + + +# When to use this asset? + +Use this asset as a reference for setting up the pre-requisites required to start utilising the Select AI capabilities available within the Oracle AI Database. The assets contains all the neccessary steps for the creation of the DB user along with required grants, access to PL/SQL packages, connection to LLM providers, setting up OCI authentication, defining OCI policies, and for setting up credentials for tools such as the OCI SMTP Server or Web Search Tool. + +It is recommend to read through the entire document before executing any of the other getting started content to ensure that you have the right pre-requisites in place for the task ahead. Different sections of the document may be relevant for different tasks, so it is important to understand the content in its entirety to ensure a smooth experience with the Select AI capabilities. + +# How to use this asset? + +This asset is provided as general purpose material. Please tailor the content according to your context and needs. + +This asset contains two versions of the same script, a SQL Script (`.sql`) to be used with an IDE such as SQLDeveloper Web or the VS Code Extension, and an OML Notebook (`.dsnb`) which can be used within the Oracle Machine Learning UI available through the Autonomous Oracle AI Database. Please use the version that is appropriate for your development environment. + + +# License + +Copyright (c) 2026 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/data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/files/00 - Setup Select AI - Anon.dsnb b/data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/files/00 - Setup Select AI - Anon.dsnb new file mode 100644 index 000000000..8ffc46c90 --- /dev/null +++ b/data-platform/data-science/oracle-select-ai/00-getting-started-setup-guide/files/00 - Setup Select AI - Anon.dsnb @@ -0,0 +1 @@ +[{"layout":"zeppelin","isRunnable":true,"template":"dsrgmn3y","templateConfig":"{\"visualization\":{\"filters\":[{\"_id\":1583324064459,\"type\":\"styling\",\"enabled\":true,\"conditions\":{\"operator\":\"and\",\"conditions\":[{\"property\":\"hiddenConnection\",\"operator\":\"*\",\"value\":\"\"}]},\"component\":\"edge\",\"target\":\"edge\",\"properties\":{\"colors\":[\"rgba(0, 0, 0, 0.1)\"],\"style\":[\"dashed\"],\"legendTitle\":[\"Hidden Connection\"]}},{\"_id\":1590499315755,\"type\":\"aggregation\",\"enabled\":true,\"conditions\":{\"operator\":\"and\",\"conditions\":[]},\"component\":\"vertex\",\"target\":\"vertex\",\"properties\":{},\"aggregation\":[{\"source\":\"\",\"type\":\"average\"}]}],\"version\":4}}","isEditable":true,"name":"00 - Setup Select AI - Anon","description":null,"type":"low","paragraphs":[{"col":0,"visualizationConfig":null,"hideInIFrame":false,"selectedVisualization":"html","title":null,"message":["%md ","

Setup Oracle Select AI within Oracle AI Database

<\/center>"],"enabled":true,"result":{"startTime":1770392631955,"interpreter":"md.low","endTime":1770392632469,"results":[{"message":"

Setup Oracle Select AI within Oracle AI Database

<\/center>\n","type":"HTML"}],"taskStatus":"SUCCESS","forms":"[]","status":"SUCCESS"},"sizeX":0,"hideCode":true,"width":12,"hideResult":false,"dynamicFormParams":"{}","row":0,"hasTitle":false,"hideVizConfig":true,"hideGutter":true,"relations":[],"forms":"[]"},{"col":0,"visualizationConfig":null,"hideInIFrame":false,"selectedVisualization":"html","title":"Pre-Requisites - Please Run any SQL/PLSQL in this Cell as ADMIN User","message":["%md","* **Create a new user**<\/span>"," * `CREATE USER IDENTIFIED BY ;` <\/br><\/br><\/br>","","* **Grant permissions to user**<\/span>"," * `GRANT CONNECT TO ;`"," * `GRANT CREATE SESSION TO ;`"," * `GRANT DWROLE TO ;`"," * `GRANT OML_DEVELOPER TO ;`"," * `GRANT EXECUTE ON DBMS_CLOUD_AI TO ;`"," * `GRANT EXECUTE ON DBMS_CLOUD_PIPELINE TO ;` "," * `GRANT EXECUTE ON DBMS_CLOUD_AI_AGENT TO ;`"," * `GRANT EXECUTE ON DBMS_NETWORK_ACL_ADMIN TO ;`"," * `GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO ;`"," * `GRANT CREATE DATABASE LINK TO ;`"," * `GRANT COMMENT ANY TABLE TO ;`"," * `GRANT READ ON SYS.V_$MAPPED_SQL TO ;`"," * `GRANT READ ON SYS.V_$SESSION TO ;`<\/br><\/br><\/br>","","* **Assign Tablespace and Quota to user**<\/span>"," * `ALTER USER DEFAULT TABLESPACE DATA;`"," * `ALTER USER QUOTA UNLIMITED ON DATA;` <\/br><\/br><\/br>","","* **If using OCI Generative AI as the LLM Provider - Set up Authentication:**<\/span>"," * Ensure correct networking is configured."," * **Option 1 - Authenticating with API Keys**"," * [Documentation](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#How)."," * Generate a set of API Keys or Upload existing API Keys to the OCI Console under your User Profile."," * Make note of your `user_ocid`, `tenancy_ocid`, `private_key`, and `fingerprint`."," * Create an OCI policy to allow users to access OCI Generative AI Service."," * `allow any-user to manage generative-ai-family in compartment `"," * Create a credential within the database for your OCI API Key."," * Example code given below in notebook."," * **Option 2 - Authenticating with Resource Principal**"," * [Documentation](https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/doc/dbms-cloud-admin.html#GUID-4DC6A536-DC78-43FE-B173-CED1F9FB45A0)."," * [Create Dynamic Group within OCI](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/resource-principal.html#GUID-3CF59CED-F7DF-46AF-B3CF-E703ED0BB3EE)."," * `ALL {resource.type='autonomousdatabase', resource.compartment.id=''}`"," * Create Policy for Dynamic Group to access OCI Generative AI Service."," * `allow dynamic-group / to manage generative-ai-family in compartment `"," * Enable resource principal in database."," * Example code given below in notebook.<\/br> <\/br><\/br>","","* **If using a 3rd Party LLM Provider - Set up Authentication:**<\/span>"," * Ensure correct networking is configured."," * Get API Key from relevant provider."," * Create a credential within the database with your 3rd Party API Key."," * Example code given below in notebook."," * Enable ACL privileges in database to access your external AI provider."," * [Documentation](https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/doc/select-ai-manage-profiles.html#GUID-3721296F-14A1-428A-B464-7FA25E9EC8F3)."," * Example code given below in notebook.<\/br><\/br><\/br>","","* **If planning on using Select AI RAG:**<\/span> "," * Generate an Auth Token within OCI Console under your User Profile."," * [Documentation](https://docs.oracle.com/en-us/iaas/Content/Registry/Tasks/registrygettingauthtoken.htm)."," * Make note of Authentication Token and OCI User Name."," * Create a Policy within OCI to allow a Group that your user is assigned to, to manage Object Storage:"," * `allow group to manage object-family in compartment `"," * Create an Object Storage Bucket within the above Compartment to upload your documents."," * Create a credential within the database with your Authentication Token."," * Example code given below in notebook.<\/br><\/br><\/br>","","","* **If planning on using Select AI Agents - Email Notification Tool:**<\/span> "," * Identify your SMTP connection endpoint for Email Delivery. You may need to subscribe to additional Oracle Cloud Infrastructure regions if Email Delivery is not available in your current region. For example, select one of the following for the SMTP connection endpoint:"," * `smtp.us-phoenix-1.oraclecloud.com`"," * `smtp.us-ashburn-1.oraclecloud.com`"," * `smtp.email.uk-london-1.oci.oraclecloud.com`"," * `smtp.email.eu-frankfurt-1.oci.oraclecloud.com`"," * [See Configure SMTP Connection for more information.](https://docs.oracle.com/iaas/Content/Email/Tasks/configuresmtpconnection.htm)."," * Generate SMTP credentials for Email Delivery."," * [See Generate SMTP Credentials for a User for more information.](https://docs.oracle.com/iaas/Content/Email/Reference/gettingstarted_topic-create-smtp-credentials.htm#top)."," * Create a credential within the database with your SMTP credentials."," * Example code given below in notebook."," * Create an approved sender for Email Delivery. Complete this step for all email addresses you will use to send email notifications from."," * [See Managing Approved Senders for more information.](https://docs.oracle.com/iaas/Content/Email/Tasks/managingapprovedsenders.htm)"," * Allow SMTP access for ADMIN user by appending an Access Control Entry (ACE)."," * Example code given below in notebook.<\/br><\/br><\/br>"," ","","* **If planning on using Select AI Translate**<\/span> "," * To use the Select AI translation feature, you must have the appropriate IAM policy permissions to access Oracle Cloud Infrastructure Language services."," * Grant the permission to use `ai-service-language-family` resource in your IAM policy. An example policy statement to grant permission to a user group in a specific compartment is:"," * `allow group to use ai-service-language-family in compartment `"," * If using Resource Principal credential, assign the permission to the Dynamic Group."," * If using Private Key credential, assign the permission to the User Group."],"enabled":true,"result":{"startTime":1777481690368,"interpreter":"md.low","endTime":1777481690928,"results":[{"message":"