diff --git a/autonomous-ai-agents/README.md b/autonomous-ai-agents/README.md index 45fc2cc..6409f5c 100644 --- a/autonomous-ai-agents/README.md +++ b/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 diff --git a/autonomous-ai-agents/jira_insight/README.md b/autonomous-ai-agents/insight_agent_for_jira/README.md similarity index 93% rename from autonomous-ai-agents/jira_insight/README.md rename to autonomous-ai-agents/insight_agent_for_jira/README.md index cd6f7bd..920e091 100644 --- a/autonomous-ai-agents/jira_insight/README.md +++ b/autonomous-ai-agents/insight_agent_for_jira/README.md @@ -1,4 +1,4 @@ -# Select AI - Jira AI Agent & Tools +# Select AI - AI Agent & Tools for JIRA ## Overview @@ -6,7 +6,7 @@ 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@ @jira_insight_tools.sql +sqlplus admin@ @insight_jira_tools.sql ``` ### Optional Configuration JSON @@ -145,7 +145,7 @@ sqlplus admin@ @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@ @jira_insight_tools.sql From `autonomous-ai-agents/jira_insight`, run after tools installation: ```sql -sqlplus admin@ @jira_insight_agent.sql +sqlplus admin@ @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 diff --git a/autonomous-ai-agents/jira_insight/jira_insight_agent.sql b/autonomous-ai-agents/insight_agent_for_jira/insight_jira_agent.sql similarity index 98% rename from autonomous-ai-agents/jira_insight/jira_insight_agent.sql rename to autonomous-ai-agents/insight_agent_for_jira/insight_jira_agent.sql index 6a1c2d2..f957697 100644 --- a/autonomous-ai-agents/jira_insight/jira_insight_agent.sql +++ b/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 diff --git a/autonomous-ai-agents/jira_insight/jira_insight_tools.sql b/autonomous-ai-agents/insight_agent_for_jira/insight_jira_tools.sql similarity index 99% rename from autonomous-ai-agents/jira_insight/jira_insight_tools.sql rename to autonomous-ai-agents/insight_agent_for_jira/insight_jira_tools.sql index 3d80db5..ca5fb3c 100644 --- a/autonomous-ai-agents/jira_insight/jira_insight_tools.sql +++ b/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 diff --git a/google-gemini-marketplace-agents/README.md b/google-gemini-marketplace-agents/oracle_ai_database_agent/README.md similarity index 100% rename from google-gemini-marketplace-agents/README.md rename to google-gemini-marketplace-agents/oracle_ai_database_agent/README.md diff --git a/google-gemini-marketplace-agents/oracle_ai_database_agent.sql b/google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent.sql similarity index 95% rename from google-gemini-marketplace-agents/oracle_ai_database_agent.sql rename to google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent.sql index 5806156..04e730a 100644 --- a/google-gemini-marketplace-agents/oracle_ai_database_agent.sql +++ b/google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent.sql @@ -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'); diff --git a/google-gemini-marketplace-agents/oracle_ai_database_agent_tool.sql b/google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent_tool.sql similarity index 97% rename from google-gemini-marketplace-agents/oracle_ai_database_agent_tool.sql rename to google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent_tool.sql index c462421..a25cdf9 100644 --- a/google-gemini-marketplace-agents/oracle_ai_database_agent_tool.sql +++ b/google-gemini-marketplace-agents/oracle_ai_database_agent/oracle_ai_database_agent_tool.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"}' );