Merge branch 'main' into sync-oci-enterprise-ai-chat-v0.9.9

Author: anshoracle

ai/generative-ai-service/a-getting-started-guide/files/.env.example

@@ -0,0 +1,44 @@
+# Copy this file to .env and replace the placeholder values before running the notebooks.
+# Do not commit your real .env file.
+
+# OCI API key authentication profile from ~/.oci/config.
+OCI_PROFILE=DEFAULT
+OCI_CONFIG_FILE=~/.oci/config
+
+# OCI compartment where Generative AI access is allowed.
+OCI_COMPARTMENT_ID=replace_with_compartment_ocid
+
+# Region-specific OCI Generative AI inference endpoint.
+GENAI_ENDPOINT=https://inference.generativeai.<region>.oci.oraclecloud.com
+
+# Model IDs available in your tenancy and region.
+# For Guide 00 and Guide 01, use a Cohere chat model if CHAT_REQUEST_FORMAT=COHERE.
+CHAT_MODEL_ID=replace_with_chat_model_id
+EMBED_MODEL_ID=cohere.embed-english-v3.0
+
+# Keep COHERE to stay close to the written OCI SDK guide.
+# Use GENERIC only if your chosen chat model requires the generic messages format.
+CHAT_REQUEST_FORMAT=COHERE
+
+# Chat generation controls.
+# CHAT_MAX_TOKENS is the visible answer budget.
+# CHAT_MAX_COMPLETION_TOKENS is the total completion budget, including reasoning.
+# Gemini 2.5 models may use many tokens for reasoning before returning visible text.
+CHAT_MAX_TOKENS=1024
+CHAT_MAX_COMPLETION_TOKENS=8192
+CHAT_REASONING_EFFORT=LOW
+
+# Oracle Database 26ai connection used by Guide 01.
+# DB_DSN can be a full connect descriptor, wallet alias, or host:port/service_name.
+TNS_ADMIN=wallets/genai_workshop_db
+DB_USER=replace_with_database_user
+# PLEASE CHANGE YOUR_PASSWORD TO A REAL PASSWORD!
+DB_PASSWORD=YOUR_PASSWORD
+# PLEASE CHANGE YOUR_PASSWORD TO A REAL PASSWORD!
+DB_WALLET_PASSWORD=YOUR_PASSWORD
+DB_DSN=replace_with_wallet_alias_low_or_medium
+DB_DOCS_TABLE=WORKSHOP_GENAI_DOCS
+
+# Local OpenAI-compatible gateway used by Guide 03.
+GATEWAY_HOST=localhost
+GATEWAY_PORT=8088

ai/generative-ai-service/a-getting-started-guide/files/.python-version

@@ -0,0 +1 @@
+3.12

ai/generative-ai-service/a-getting-started-guide/files/README.md

@@ -0,0 +1,16 @@
+# OCI Generative AI Workshop Files
+
+Run commands in this directory.
+
+1. Install dependencies with `uv sync`.
+2. Copy `.env.example` to `.env`.
+3. Replace placeholder values in `.env`.
+4. Open the notebooks in `notebooks` or start the gateway with:
+
+```bash
+uv run python -m uvicorn workshop_gateway.app:app --host localhost --port 8088
+```
+
+Copyright (c) 2026 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.

ai/generative-ai-service/a-getting-started-guide/files/n8n/oci-genai-gateway-summarizer.workflow.json

@@ -0,0 +1,100 @@
+{
+  "name": "OCI GenAI Gateway - Summarizer Demo",
+  "nodes": [
+    {
+      "parameters": {
+        "httpMethod": "POST",
+        "path": "oci-genai-summary",
+        "responseMode": "responseNode",
+        "options": {}
+      },
+      "id": "b6f5b7d2-df7b-4d0a-b0e9-568fc6acb921",
+      "name": "Webhook",
+      "type": "n8n-nodes-base.webhook",
+      "typeVersion": 2,
+      "position": [
+        -460,
+        0
+      ]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "http://host.docker.internal:8088/v1/chat/completions",
+        "sendHeaders": true,
+        "headerParameters": {
+          "parameters": [
+            {
+              "name": "Content-Type",
+              "value": "application/json"
+            },
+            {
+              "name": "Authorization",
+              "value": "Bearer not-used"
+            }
+          ]
+        },
+        "sendBody": true,
+        "specifyBody": "json",
+        "jsonBody": "={\n  \"model\": \"google.gemini-2.5-flash\",\n  \"messages\": [\n    {\n      \"role\": \"system\",\n      \"content\": \"You are a concise assistant for a integration example. Return a 3-sentence summary.\"\n    },\n    {\n      \"role\": \"user\",\n      \"content\": $json.body.text\n    }\n  ],\n  \"temperature\": 0.2,\n  \"max_tokens\": 300\n}",
+        "options": {}
+      },
+      "id": "2ff737cf-b299-4ca5-9c83-c4e5e40f3e4d",
+      "name": "Call OCI GenAI Gateway",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [
+        -160,
+        0
+      ]
+    },
+    {
+      "parameters": {
+        "respondWith": "json",
+        "responseBody": "={\n  \"summary\": $json.choices[0].message.content,\n  \"model\": $json.model,\n  \"gateway_response_id\": $json.id\n}",
+        "options": {}
+      },
+      "id": "9beb5173-e486-48b4-a551-a31b0567eeeb",
+      "name": "Respond to Webhook",
+      "type": "n8n-nodes-base.respondToWebhook",
+      "typeVersion": 1.4,
+      "position": [
+        140,
+        0
+      ]
+    }
+  ],
+  "connections": {
+    "Webhook": {
+      "main": [
+        [
+          {
+            "node": "Call OCI GenAI Gateway",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Call OCI GenAI Gateway": {
+      "main": [
+        [
+          {
+            "node": "Respond to Webhook",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "pinData": {},
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "staticData": null,
+  "tags": [],
+  "triggerCount": 0,
+  "updatedAt": "2026-05-11T00:00:00.000Z",
+  "versionId": "5aa64ad6-6e34-4a76-b096-5cb9f989d4ad"
+}

ai/generative-ai-service/a-getting-started-guide/files/n8n/sample-summary-request.json

@@ -0,0 +1,3 @@
+{
+  "text": "Oracle Database can store vectors for semantic search. OCI Generative AI can create embeddings and generate grounded answers. n8n can orchestrate low-code workflows by calling an OpenAI-compatible gateway."
+}