removed imports added by AI

Author: aosingh

doc/source/user_guide/agent.rst

@@ -11,6 +11,7 @@ agents and run teams from Python using the existing select_ai connection objects
 
 - Group agents into teams and invoke them with a single API call
 
+.. latex:clearpage::
 
 ********
 ``Tool``
@@ -96,6 +97,8 @@ language translation to SQL using an OCI AI profile
    :language: python
    :lines: 14-
 
+.. latex:clearpage::
+
 output::
 
     MOVIE_SQL_TOOL
@@ -255,3 +258,37 @@ Run Team
 output::
 
     To list the movies, you can use the SQL query: SELECT m.* FROM "SPARK_DB_USER"."MOVIE" m.
+
+.. latex:clearpage::
+
+*****************
+AI agent examples
+*****************
+
+Web Search Agent using OpenAI's GPT model
++++++++++++++++++++++++++++++++++++++++++
+
+.. literalinclude:: ../../../samples/agent/websearch_agent.py
+   :language: python
+
+output::
+
+    Created credential:  OPENAI_CRED
+    Created profile:  OPENAI_PROFILE
+    Created tool:  WEB_SEARCH_TOOL
+    The key features of Oracle Database Machine Learning, as highlighted on the Oracle website, include:
+
+    - In-database machine learning: Build, train, and deploy machine learning models directly inside the Oracle Database, eliminating the need to move data.
+    - Support for multiple languages: Use SQL, Python, and R for machine learning tasks, allowing flexibility for data scientists and developers.
+    - Automated machine learning (AutoML): Automates feature selection, model selection, and hyperparameter tuning to speed up model development.
+    - Scalability and performance: Utilizes Oracle Database’s scalability, security, and high performance for machine learning workloads.
+    - Integration with Oracle Cloud: Seamlessly integrates with Oracle Cloud Infrastructure for scalable and secure deployment.
+    - Security and governance: Inherits Oracle Database’s robust security, data privacy, and governance features.
+    - Prebuilt algorithms: Offers a wide range of in-database algorithms for classification, regression, clustering, anomaly detection, and more.
+    - No data movement: Keeps data secure and compliant by performing analytics and machine learning where the data resides.
+
+    These features enable organizations to operationalize machine learning at scale, improve productivity, and maintain data security and compliance.
+
+    The main topic at the URL https://www.oracle.com/artificial-intelligence/database-machine-learning is Oracle's database machine learning capabilities, specifically how Oracle integrates artificial intelligence and machine learning features directly into its database products. The page highlights how users can leverage these built-in AI and ML tools to analyze data, build predictive models, and enhance business applications without moving data outside the Oracle Database environment.
+
+    The main topic of the website https://openai.com is artificial intelligence research and development. OpenAI focuses on creating and promoting advanced AI technologies, including products like ChatGPT, and provides information about their research, products, and mission to ensure that artificial general intelligence benefits all of humanity.

samples/agent/tool_create.py

@@ -23,19 +23,18 @@
 
 select_ai.connect(user=user, password=password, dsn=dsn)
 
-provider = select_ai.OCIGenAIProvider(
-    region="us-chicago-1",
-    oci_apiformat="GENERIC",
-    model="meta.llama-4-maverick-17b-128e-instruct-fp8",
-)
 profile_attributes = select_ai.ProfileAttributes(
     credential_name="my_oci_ai_profile_key",
     object_list=[
         {"owner": user, "name": "MOVIE"},
         {"owner": user, "name": "ACTOR"},
         {"owner": user, "name": "DIRECTOR"},
     ],
-    provider=provider,
+    provider=select_ai.OCIGenAIProvider(
+        region="us-chicago-1",
+        oci_apiformat="GENERIC",
+        model="meta.llama-4-maverick-17b-128e-instruct-fp8",
+    ),
 )
 profile = select_ai.Profile(
     profile_name="LLAMA_4_MAVERICK",
@@ -49,7 +48,7 @@
 sql_tool = select_ai.agent.Tool.create_sql_tool(
     tool_name="MOVIE_SQL_TOOL",
     description="My Select AI MOVIE SQL agent tool",
-    profile_name="oci_ai_profile",
+    profile_name="LLAMA_4_MAVERICK",
     replace=True,
 )
 print(sql_tool.tool_name)

src/select_ai/agent/core.py

@@ -19,7 +19,6 @@
 )
 
 import oracledb
-from docutils.nodes import description
 
 from select_ai import BaseProfile
 from select_ai._abc import SelectAIDataClass

src/select_ai/agent/tool.py

@@ -11,7 +11,6 @@
 from typing import AsyncGenerator, Iterator, List, Mapping, Optional, Union
 
 import oracledb
-from oci.generative_ai_agent.models import Tool
 
 from select_ai import BaseProfile
 from select_ai._abc import SelectAIDataClass
@@ -318,7 +317,7 @@ def create_built_in_tool(
         tool_type: ToolType,
         description: Optional[str] = None,
         replace: Optional[bool] = False,
-    ) -> Tool:
+    ) -> "Tool":
         """
         Register a built-in tool
 
@@ -356,7 +355,7 @@ def create_email_notification_tool(
         smtp_host: str,
         description: Optional[str],
         replace: bool = False,
-    ) -> Tool:
+    ) -> "Tool":
         """
         Register an email notification tool
 
@@ -394,7 +393,7 @@ def create_http_tool(
         endpoint: str,
         description: Optional[str] = None,
         replace: bool = False,
-    ) -> Tool:
+    ) -> "Tool":
         http_tool_params = HTTPToolParams(
             credential_name=credential_name, endpoint=endpoint
         )
@@ -413,7 +412,7 @@ def create_pl_sql_tool(
         function: str,
         description: Optional[str] = None,
         replace: bool = False,
-    ) -> Tool:
+    ) -> "Tool":
         """
         Create a custom tool to invoke PL/SQL procedure or function
 
@@ -440,7 +439,7 @@ def create_rag_tool(
         profile_name: str,
         description: Optional[str] = None,
         replace: bool = False,
-    ) -> Tool:
+    ) -> "Tool":
         """
         Register a RAG tool, which will use a VectorIndex linked AI Profile
 
@@ -467,7 +466,7 @@ def create_sql_tool(
         profile_name: str,
         description: Optional[str] = None,
         replace: bool = False,
-    ) -> Tool:
+    ) -> "Tool":
         """
         Register a SQL tool to perform natural language to SQL translation
 
@@ -495,7 +494,7 @@ def create_slack_notification_tool(
         slack_channel: str,
         description: Optional[str] = None,
         replace: bool = False,
-    ) -> Tool:
+    ) -> "Tool":
         """
         Register a Slack notification tool
 
@@ -526,7 +525,7 @@ def create_websearch_tool(
         credential_name: str,
         description: Optional[str],
         replace: bool = False,
-    ) -> Tool:
+    ) -> "Tool":
         """
         Register a built-in websearch tool to search information
         on the web
@@ -577,7 +576,7 @@ def enable(self):
         pass
 
     @classmethod
-    def fetch(cls, tool_name: str) -> Tool:
+    def fetch(cls, tool_name: str) -> "Tool":
         """
         Fetch AI Tool attributes from the Database and build a proxy object in
         the Python layer

src/select_ai/vector_index.py

@@ -24,6 +24,16 @@
     LIST_USER_VECTOR_INDEXES,
 )
 
+UNMODIFIABLE_VECTOR_INDEX_ATTRIBUTES = (
+    "location",
+    "chunk_size",
+    "chunk_overlap",
+    "pipeline_name",
+    "vector_dimension",
+    "vector_table_name",
+    "vector_distance_metric",
+)
+
 
 class VectorDBProvider(StrEnum):
     ORACLE = "oracle"
@@ -170,6 +180,8 @@ def _get_attributes(index_name: str) -> VectorIndexAttributes:
         :return: select_ai.VectorIndexAttributes
         :raises: VectorIndexNotFoundError
         """
+        if index_name is None:
+            raise AttributeError("'index_name' is required")
         with cursor() as cr:
             cr.execute(
                 GET_USER_VECTOR_INDEX_ATTRIBUTES, index_name=index_name.upper()

src/select_ai/version.py

@@ -5,4 +5,4 @@
 # http://oss.oracle.com/licenses/upl.
 # -----------------------------------------------------------------------------
 
-__version__ = "1.1.0"
+__version__ = "1.2.0rc1"