Merge pull request #76 from sandeepkhot/JIRA_AGENT_UPDATE

Document update for JIRA

Author: jpmc-github

autonomous-ai-agents/README.md

@@ -13,11 +13,11 @@ https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/doc/select-ai-
 
 ---
 
-## What is a Select AI Agent?
+## What is a Select AI Agent Framework?
 
-Select AI Agent is part of Oracle Autonomous AI Database and extends core Select AI capabilities, including NL2SQL and RAG.
+Select AI Agent Framework is part of Oracle Autonomous AI Database and extends core Select AI capabilities, including NL2SQL and RAG.
 
-A Select AI Agent:
+An AI agent built using the Select AI Agent framework:
 
 - Accepts natural language input from users or programs
 - Uses an LLM to reason about the request

…onomous-ai-agents/jira_insight/README.md …-agents/insight_agent_for_jira/README.mdautonomous-ai-agents/jira_insight/README.md renamed to autonomous-ai-agents/insight_agent_for_jira/README.md autonomous-ai-agents/jira_insight/README.md renamed to autonomous-ai-agents/insight_agent_for_jira/README.md

@@ -1,12 +1,12 @@
-# Select AI - Jira AI Agent & Tools
+# Select AI - AI Agent & Tools for JIRA
 
 ## Overview
 
 ## Jira Integration
 
 Jira integration in this project connects Oracle Autonomous AI Database to Atlassian Jira Cloud APIs through `DBMS_CLOUD`, then exposes those operations as Select AI tools via `DBMS_CLOUD_AI_AGENT`.
 
-The **Select AI Jira Agent** enables conversational Jira operations such as issue search, issue insight generation, assignee lookup, comments/changelog/worklog retrieval, project lookup, user lookup, and board discovery.
+The **Select AI Insight agent for Jira** enables conversational Jira operations such as issue search, issue insight generation, assignee lookup, comments/changelog/worklog retrieval, project lookup, user lookup, and board discovery.
 
 Runtime connection settings are stored in `SELECTAI_AGENT_CONFIG` under agent key `JIRA`, so credentials and Jira Cloud ID are centrally managed and not passed as user inputs on every tool call.
 
@@ -55,13 +55,13 @@ Formatted Jira/Atlassian Response
 
 ```text
 .
-├── jira_insight_tools.sql
+├── insight_jira_tools.sql
 │   ├── Configuration bootstrap (SELECTAI_AGENT_CONFIG)
 │   ├── Jira API wrapper package (jira_selectai)
 │   ├── Agent package (select_ai_jira_agent)
 │   └── Jira AI tool registrations
 │
-├── jira_insight_agent.sql
+├── insight_jira_agent.sql
 │   ├── Task definition (JIRA_TASKS)
 │   ├── Agent creation (JIRA_ADVISOR)
 │   ├── Team creation (JIRA_INSIGHT_TEAM)
@@ -97,7 +97,7 @@ Before running installation commands:
 Run as `ADMIN` (or another privileged user):
 
 ```sql
-sqlplus admin@<adb_connect_string> @jira_insight_tools.sql
+sqlplus admin@<adb_connect_string> @insight_jira_tools.sql
 ```
 
 ### Optional Configuration JSON
@@ -145,7 +145,7 @@ sqlplus admin@<adb_connect_string> @jira_insight_tools.sql
 ### Comment Updates
 - `UPDATE_JIRA_COMMENT_TOOL`
 
-### Tool-to-Function Mapping (from `jira_insight_tools.sql`)
+### Tool-to-Function Mapping (from `insight_jira_tools.sql`)
 
 | Tool | Function | Purpose |
 |------|----------|---------|
@@ -168,10 +168,10 @@ sqlplus admin@<adb_connect_string> @jira_insight_tools.sql
 From `autonomous-ai-agents/jira_insight`, run after tools installation:
 
 ```sql
-sqlplus admin@<adb_connect_string> @jira_insight_agent.sql
+sqlplus admin@<adb_connect_string> @insight_jira_agent.sql
 ```
 
-You can also execute the contents of `jira_insight_agent.sql` in SQL Worksheet.
+You can also execute the contents of `insight_jira_agent.sql` in SQL Worksheet.
 
 ### Prompts
 

…ents/jira_insight/jira_insight_agent.sql …ht_agent_for_jira/insight_jira_agent.sqlautonomous-ai-agents/jira_insight/jira_insight_agent.sql renamed to autonomous-ai-agents/insight_agent_for_jira/insight_jira_agent.sql autonomous-ai-agents/jira_insight/jira_insight_agent.sql renamed to autonomous-ai-agents/insight_agent_for_jira/insight_jira_agent.sql

@@ -5,7 +5,7 @@ rem   Licensed under the Universal Permissive License (UPL), Version 1.0
 rem   https://oss.oracle.com/licenses/upl/
 rem
 rem NAME
-rem   jira_insight_agent.sql
+rem   insight_jira_agent.sql
 rem
 rem DESCRIPTION
 rem   Installer and configuration script for Jira AI Agent Team
@@ -52,13 +52,13 @@ rem   5. Execution:
 rem        - Execute installer procedure with AI profile parameter
 rem
 rem INSTALL INSTRUCTIONS
-rem   1. Run jira_insight_tools.sql first.
+rem   1. Run insight_jira_tools.sql first.
 rem
 rem   2. Connect as ADMIN or a privileged user.
 rem
 rem   3. Run the script using SQL*Plus or SQLcl:
 rem
-rem      sqlplus admin@db @jira_insight_agent.sql
+rem      sqlplus admin@db @insight_jira_agent.sql
 rem
 rem   4. Provide inputs when prompted:
 rem        - Target schema name

…ents/jira_insight/jira_insight_tools.sql …ht_agent_for_jira/insight_jira_tools.sqlautonomous-ai-agents/jira_insight/jira_insight_tools.sql renamed to autonomous-ai-agents/insight_agent_for_jira/insight_jira_tools.sql autonomous-ai-agents/jira_insight/jira_insight_tools.sql renamed to autonomous-ai-agents/insight_agent_for_jira/insight_jira_tools.sql

@@ -5,7 +5,7 @@ rem   Licensed under the Universal Permissive License (UPL), Version 1.0
 rem   https://oss.oracle.com/licenses/upl/
 rem
 rem NAME
-rem   jira_insight_tools.sql
+rem   insight_jira_tools.sql
 rem
 rem DESCRIPTION
 rem   Installer script for Jira Select AI tools

…ogle-gemini-marketplace-agents/README.md …gents/oracle_ai_database_agent/README.mdgoogle-gemini-marketplace-agents/README.md renamed to google-gemini-marketplace-agents/oracle_ai_database_agent/README.md google-gemini-marketplace-agents/README.md renamed to google-gemini-marketplace-agents/oracle_ai_database_agent/README.md

@@ -264,7 +264,7 @@ BEGIN
         '"process":"sequential"' ||
         '}',
       description =>
-        'The Oracle Autonomous AI Database Agent for Natural Language Queries (Preview) provides a seamless natural language interface for querying enterprise data stored in Oracle Database on Google Cloud. Integrated with Gemini Enterprise, this agent removes the need to build custom natural language processing pipelines by automatically translating plain text inputs into optimized SQL queries. It executes these queries against your Oracle database, retrieves results, and returns formatted data interpretations, all within the Gemini experience.'
+        'Oracle AI Database Agent provides a natural language interface for querying enterprise data stored in Oracle AI Database on Google Cloud. Integrated with Gemini Enterprise, this agent removes the need to build custom natural language processing pipelines by automatically translating plain text inputs into SQL queries. It executes these queries against your Oracle database, retrieves results, and returns formatted data interpretations, all within the Gemini experience.'
   );
 
   DBMS_OUTPUT.PUT_LINE('Created team ORACLE_AI_DATABASE_TEAM');

…lace-agents/oracle_ai_database_agent.sql …abase_agent/oracle_ai_database_agent.sqlgoogle-gemini-marketplace-agents/oracle_ai_database_agent.sql renamed to google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent.sql google-gemini-marketplace-agents/oracle_ai_database_agent.sql renamed to google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent.sql

@@ -555,7 +555,7 @@ BEGIN
 
    DBMS_CLOUD_AI_AGENT.create_tool(
     tool_name  => 'SQL_TOOL',
-    description => 'Executes database queries based on natural language questions. Converts plain English requests into optimized SQL, runs them against your Oracle AI Database, and returns the results. If no data is found, suggests options to refine the query using column ranges or distinct values.',
+    description => 'Generates a SQL query from the provided natural language prompt and runs that query against your Oracle AI Database, returning the results. If no data is found, consider revising your prompt to be more descriptive.',
     attributes => '{"instruction": "This tool can access the data in database. It will take user question as user_prompt and generate a sql query, and then it will execute the sql query to get the result' ||
                                     ' If the result is 0 rows. It''s possible that there is an predicates issue. Please use RANGE_VALUES_CHECK for Numeric, DATE, or TIMESTAMP types or DISTINCT_VALUES_CHECK tool for other datatype columns to get all the distinct values and reinvoke the tool with a refined the user question", 
                     "function": "oracle_ai_data_retrieval_functions.runsql_func"}'
@@ -565,7 +565,7 @@ BEGIN
 
    DBMS_CLOUD_AI_AGENT.create_tool(
     tool_name  => 'RANGE_VALUES_CHECK',
-    description => ' Retrieves the minimum and maximum values for a numeric, date, or timestamp column in your table. Useful for understanding data boundaries or refining searches.',
+    description => 'Retrieves the minimum and maximum values for a numeric, date, or timestamp column in your table. Useful for understanding data boundaries or refining searches.',
     attributes => '{
       "instruction": "This tool returns the minimum and maximum (range) values of a column in the given table. Only Numeric, DATE, or TIMESTAMP types columns are supported.",
       "function": "oracle_ai_data_retrieval_functions.get_range_values_func"
@@ -576,7 +576,7 @@ BEGIN
 
    DBMS_CLOUD_AI_AGENT.create_tool(
     tool_name  => 'GENERATE_CHART',
-    description => 'Creates charts, graphs, or visualizations based on your data and preferences. Specify chart type, underlying data, and labels to generate formatted HTML or image output for display.',
+    description => 'Creates charts or visualizations based on your data and preferences. Specify chart type, underlying data, and labels to generate formatted HTML or image output for display.',
     attributes => '{"instruction": "Use this tool when you need to generate a chart, graph, or visualization based on data. Provide a detailed prompt describing the chart type, data, labels, titles, and any other details. The tool will return formatted HTML for embedding the chart in the response.", 
                     "function": "oracle_ai_data_retrieval_functions.generate_chart_func"}'
    );