Updated README files

Author: sandeepkhot

autonomous-ai-agents/README.md

@@ -64,6 +64,67 @@ The repository is organized to align with the Select AI Agent framework:
 
 ---
 
+## Agent Configuration (`SELECTAI_AGENT_CONFIG`)
+
+### Overview
+
+Select AI agents use a shared configuration table named `SELECTAI_AGENT_CONFIG` to store **agent-specific configuration parameters**.
+
+The table is generic and can be used by any Select AI agent (for example, NL2SQL data retrieval agents or other domain-specific agents). Each agent persists only the configuration keys it requires, while default behavior applies when values are not provided.
+
+---
+
+### Column Description
+
+| Column | Description |
+|------|------------|
+| `ID` | System-generated unique identifier |
+| `KEY` | Configuration parameter name |
+| `VALUE` | Configuration value (stored as CLOB) |
+| `AGENT` | Logical name of the Select AI agent(Available in tools) |
+
+Configuration entries are uniquely identified by the combination of `KEY` and `AGENT`.
+
+---
+
+### Writing Configuration Entries
+
+Configuration values are written during agent installation or setup.  
+Only explicitly provided values are persisted; agents apply internal defaults when values are absent.
+
+---
+
+### Example Configuration Entries
+
+#### NL2SQL Data Retrieval Agent
+
+```sql
+INSERT INTO SELECTAI_AGENT_CONFIG ("KEY", "VALUE", "AGENT")
+VALUES ('ENABLE_RESOURCE_PRINCIPAL', 'YES', 'NL2SQL_DATA_RETRIEVAL_AGENT');
+
+INSERT INTO SELECTAI_AGENT_CONFIG ("KEY", "VALUE", "AGENT")
+VALUES ('CREDENTIAL_NAME', 'MY_DB_CREDENTIAL', 'NL2SQL_DATA_RETRIEVAL_AGENT');
+```
+
+### JSON-Based Configuration Input
+
+Agent installers may accept configuration as JSON input.
+
+Example:
+
+```{
+  "use_resource_principal": true,
+  "credential_name": "MY_DB_CREDENTIAL"
+}
+```
+
+The installer parses the JSON and stores the relevant values in SELECTAI_AGENT_CONFIG.
+
+### Reading Configuration at Runtime
+
+At runtime, agents read their configuration from SELECTAI_AGENT_CONFIG and consume it as structured JSON. This allows configuration changes without modifying agent code.
+
+
 ## Supported Use Cases
 
 This framework can be used to build Select AI agents for:

autonomous-ai-agents/nl2sql_data_retrieval/README.md

@@ -32,7 +32,7 @@ into a **single autonomous agent workflow**.
 | External web search | ❌ | ✅ |
 | URL content validation | ❌ | ✅ |
 | Chart generation | ❌ | ✅ |
-| Config-driven & extensible | ❌ | ✅ |
+| Config-driven and extensible | ❌ | ✅ |
 
 > **Result:** Higher accuracy, fewer hallucinations, accurate SQL, and richer analytical answers.
 
@@ -100,10 +100,10 @@ All credentials are resolved **securely at runtime from OCI Vault**.
 - https://console.cloud.google.com
 
 ### Step 2: Enable Custom Search API
-- APIs & Services → Library → **Custom Search API**
+- APIs and Services → Library → **Custom Search API**
 
 ### Step 3: Create API Key
-- APIs & Services → Credentials → **Create API Key**
+- APIs and Services → Credentials → **Create API Key**
 
 ### Step 4: Create Custom Search Engine (CX)
 - https://programmablesearchengine.google.com  
@@ -126,7 +126,7 @@ Run as ADMIN (or privileged user):
 ```sql
 sqlplus admin@db @nl2sql_data_retrieval_tools.sql
 ```
-### Input Parameters required to run.
+### Input Parameters required to run
 - Target schema name (Schema where to the agent team needs to be installed)
 - Cloud Config Parameters required for Websearch (This is mandatory to enable Websearch)
   - Google Search API Keys needs to be stored in OCI Vault
@@ -211,7 +211,7 @@ sqlplus admin@db @nl2sql_data_retrieval_tools.sql
 
 ---
 
-##  Installation – Agent & Team
+##  Installation – Agent and Team
 
 Run:
 
@@ -259,7 +259,7 @@ Specialize agents using tasks.**
 | Data Retrieval Team | All tools | General analytics |
 | Finance Analytics Team | SQL + RANGE | Financial reporting |
 | Research Agent Team | WEBSEARCH | External intelligence |
-| Visualization Team | SQL + CHART | Dashboards & insights |
+| Visualization Team | SQL + CHART | Dashboards and insights |
 
 ### Why This Scales Well
 - Tools are reusable  

autonomous-ai-agents/oci_autonomous_database/README.md

@@ -1,4 +1,4 @@
-# Select AI - OCI Autonomous Database AI Agent & Tools
+# Select AI - OCI Autonomous Database AI Agent and Tools
 
 ##  Overview
 
@@ -33,12 +33,12 @@ User Request
    ↓
 OCI Autonomous Database Task
    ↓
-Agent Reasoning & Validation
+Agent Reasoning and Validation
    ├── Discovery Tools (Regions, Compartments, Databases)
    ├── Provisioning Tools
    ├── Lifecycle Management Tools
-   ├── Configuration & Scaling Tools
-   └── Maintenance & Backup Tools
+   ├── Configuration and Scaling Tools
+   └── Maintenance and Backup Tools
    ↓
 Confirmed OCI Operation + Result
 ```
@@ -51,7 +51,7 @@ Confirmed OCI Operation + Result
 .
 ├── oci_autonomous_database_tools.sql
 │   ├── PL/SQL OCI wrapper package
-│   ├── OCI authentication & config handling
+│   ├── OCI authentication and config handling
 │   ├── Autonomous Database lifecycle functions
 │   └── AI tool registrations
 │
@@ -84,7 +84,7 @@ Run as ADMIN (or privileged user):
 sqlplus admin@db @oci_autonomous_database_tools.sql
 ```
 
-### Input Parameters required to run.
+### Input Parameters required to run
 - Target schema name (Schema where to the agent team needs to be installed)
 - Cloud Config Parameters.
   - OCI Credentials - Required to access to Object Storage buckets.
@@ -113,29 +113,29 @@ sqlplus admin@db @oci_autonomous_database_tools.sql
 
 ##  Available AI Tools (High Level)
 
-### 🔍 Discovery & Metadata
+### 🔍 Discovery and Metadata
 - List subscribed regions
 - List compartments
 - Resolve compartment OCID by name
 - List Autonomous Databases
 - Get Autonomous Database details
 
-###  Provisioning & Lifecycle
+###  Provisioning and Lifecycle
 - Provision Autonomous Database
 - Start / Stop / Restart database
 - Scale CPU and storage
 - Enable / manage autoscaling
 - Shrink database
 - Delete Autonomous Database (confirmed)
 
-###  Configuration & Updates
+###  Configuration and Updates
 - Update database attributes
 - Manage power model
 - Modify workload and edition
 - Update network and security settings
 - Manage tags
 
-###  Maintenance & Backup
+###  Maintenance and Backup
 - List maintenance run history
 - List Autonomous Database backups
 - List DB homes
@@ -144,7 +144,7 @@ sqlplus admin@db @oci_autonomous_database_tools.sql
 
 ---
 
-##  Installation – Agent & Team
+##  Installation – Agent and Team
 
 Run:
 
@@ -177,7 +177,7 @@ The task enforces:
 
 ---
 
-##  Extending & Generalizing the Agent
+##  Extending and Generalizing the Agent
 
 ### Recommended Pattern
 
@@ -207,23 +207,23 @@ Bind profiles at agent level.**
 
 After creating the Oracle Autonomous Database AI Agent, users can interact with it using prompts such as:
 
-### Discovery & Setup
+### Discovery and Setup
 - “List all OCI regions I am subscribed to.”
 - “Show all compartments in my tenancy.”
 
 ### Provisioning Autonomous Databases
 - “Help me to Provision a new Autonomous Transaction Processing database"
 
-### Listing & Inspecting Databases
+### Listing and Inspecting Databases
 - “List all Autonomous Databases in the `Finance` compartment in the Mumbai region.”
 - “Get detailed information for the Autonomous Database with OCID `<db_ocid>`.”
 
-### Power & Lifecycle Management
+### Power and Lifecycle Management
 - “Start the Autonomous Database with OCID `<db_ocid>` in the Mumbai region.”
 - “Stop the Autonomous Database with OCID `<db_ocid>`.”
 - “Restart the Autonomous Database with OCID `<db_ocid>`.”
 
-### Scaling & Resource Management
+### Scaling and Resource Management
 - “Increase the CPU count of the Autonomous Database `<db_ocid>` to 8 cores.”
 - “Update the storage size of the Autonomous Database `<db_ocid>` to 2 TB.”
 - “Shrink the Autonomous Database `<db_ocid>` to optimize storage usage.”
@@ -232,7 +232,7 @@ After creating the Oracle Autonomous Database AI Agent, users can interact with
 - “Enable auto-scaling and update the display name for the Autonomous Database `<db_ocid>`.”
 - “Update backup retention to 30 days for the Autonomous Database `<db_ocid>`.”
 
-### Maintenance & Backups
+### Maintenance and Backups
 - “Show maintenance run history for maintenance run ID `<maintenance_id>`.”
 - “List all backups for the Autonomous Database `<db_ocid>` in the `Finance` compartment.”
 

autonomous-ai-agents/oci_network_load_balancer/README.md

@@ -1,4 +1,4 @@
-#  Select AI - OCI Network Load Balancer AI Agent & Tools 
+#  Select AI - OCI Network Load Balancer AI Agent and Tools 
 
 ## Overview
 
@@ -38,12 +38,12 @@ User Request
    ↓
 OCI Network Load Balancer Task
    ↓
-Agent Reasoning & Validation
-   ├── Region & Compartment Discovery
-   ├── NLB Inventory & Inspection
+Agent Reasoning and Validation
+   ├── Region and Compartment Discovery
+   ├── NLB Inventory and Inspection
    ├── Listener Management
-   ├── Backend Set & Backend Inspection
-   ├── Health & Policy Discovery
+   ├── Backend Set and Backend Inspection
+   ├── Health and Policy Discovery
    └── Destructive Action Confirmation
    ↓
 Confirmed NLB Operation + Result
@@ -80,15 +80,15 @@ Confirmed NLB Operation + Result
 
 ---
 
-##  Installation – Agent & Team
+##  Installation – Agent and Team
 
 Run as ADMIN (or privileged user):
 
 ```sql
 sqlplus admin@db @oci_network_load_balancer_agent.sql
 ```
 
-### Input Parameters required to run.
+### Input Parameters required to run
 - Target schema name (Schema where to the agent team needs to be installed)
 - AI Profile name (Select AI Profile name that needs to be used with the Agent)
 
@@ -132,13 +132,13 @@ sqlplus admin@db @oci_network_load_balancer_agent.sql
 - Update listener
 - Delete listener
 
-###  Backend & Health
+###  Backend and Health
 - Create backend sets
 - List backend sets
 - List backends
 - Inspect health checks
 
-###  Metadata & Capabilities
+###  Metadata and Capabilities
 - List supported NLB policies
 - List supported protocols
 - Review NLB health summaries
@@ -167,7 +167,7 @@ Bind permissions via AI profiles.**
 
 ### Example Extensions
 - Read-only NLB inventory agent
-- Health monitoring & diagnostics agent
+- Health monitoring and diagnostics agent
 - Automated NLB provisioning agent
 - Multi-compartment governance agent
 
@@ -187,15 +187,15 @@ Bind permissions via AI profiles.**
 
 After creating the OCI Network Load Balancer AI Agent, users can interact with it using prompts such as:
 
-### Discovery & Setup
+### Discovery and Setup
 - “List all OCI regions I am subscribed to.”
 - “Show all compartments in my tenancy.”
 
 ### Network Load Balancer Provisioning
 - “Create a public Network Load Balancer named `orders-nlb` in the `Finance` compartment in the Mumbai region with a TCP listener on port 443, a backend set using ROUND_ROBIN policy, and health checks enabled.”
 - “Create a private Network Load Balancer in the `Finance` compartment with preserved source IP and IPv4 enabled.”
 
-### Listing & Inspecting Network Load Balancers
+### Listing and Inspecting Network Load Balancers
 - “List all Network Load Balancers in the `Finance` compartment in the Mumbai region.”
 - “Get details of the Network Load Balancer with OCID `<nlb_ocid>`.”
 
@@ -206,12 +206,12 @@ After creating the OCI Network Load Balancer AI Agent, users can interact with i
 - “Update the listener `https-listener` to use a different backend set.”
 - “Delete the listener named `https-listener` from the Network Load Balancer `<nlb_ocid>`.”
 
-### Backend Sets & Backends
+### Backend Sets and Backends
 - “List all backend sets for the Network Load Balancer `<nlb_ocid>`.”
 - “Create a backend set named `orders-backend-set` with ROUND_ROBIN policy on port 8080.”
 - “List all backends in the backend set `orders-backend-set` for the Network Load Balancer `<nlb_ocid>`.”
 
-### Health, Policies & Protocols
+### Health, Policies and Protocols
 - “Show health status of all Network Load Balancers in the `Finance` compartment.”
 - “List all supported Network Load Balancer policies.”
 - “List all supported Network Load Balancer protocols.”
@@ -234,12 +234,12 @@ https://oss.oracle.com/licenses/upl/
 
 ---
 
-## ✨ Final Thought
+## ✨ Final Thoughts
 
 The OCI Network Load Balancer AI Agent transforms complex networking operations into a **guided, and auditable conversational workflow**, reducing risk while accelerating infrastructure management.
 
 Designed for:
-- Platform & networking teams
+- Platform and networking teams
 - Cloud operations engineers
 - Secure infrastructure automation
 - Enterprise OCI environments