Releasing version 2.152.0

Releasing version 2.152.0

Author: oci-dex-release-bot

CHANGELOG.rst

@@ -4,6 +4,25 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
 
+====================
+2.152.0 - 2025-05-13
+====================
+
+Added 
+----- 
+* Support for the Model Deployment service  
+* Support for enabling and monitoring Pluggable Databases(PDB) in the Database Management service 
+* Support for additional unit shapes in AI clusters in the Generative AI service 
+* Support for node search details and node shape details on create and update cluster operations in the OpenSearch service   
+
+Breaking 
+-------- 
+* Models `DisableExternalMysqlAssociatedServiceDetails` and `EnableExternalMysqlAssociatedServiceDetails` removed from the Database Management service 
+* Property `lifecycle_state` removed from model `ExadataInfrastructureLifecycleStateValues` in the Database Management service 
+* Operations `disable_external_mysql_associated_service` and `enable_external_mysql_associated_service` removed from `ManagedMySqlDatabasesClient` in the Database Management service 
+* Default retries disabled for operations `get_named_credential` and `list_named_credentials` from `DbManagementClient` in the Database Management service 
+* Operation `modify_external_container_database_management_feature` removed from `DbManagementClient` in the Database Management service   
+
 ====================
 2.151.0 - 2025-05-06
 ====================

docs/api/database_management.rst

@@ -183,7 +183,6 @@ Database Management
     oci.database_management.models.DisableAutonomousDatabaseManagementFeatureDetails
     oci.database_management.models.DisableDatabaseManagementFeatureDetails
     oci.database_management.models.DisableExternalContainerDatabaseManagementFeatureDetails
-    oci.database_management.models.DisableExternalMysqlAssociatedServiceDetails
     oci.database_management.models.DisableExternalNonContainerDatabaseManagementFeatureDetails
     oci.database_management.models.DisableExternalPluggableDatabaseManagementFeatureDetails
     oci.database_management.models.DisableHighFrequencyAutomaticSpmEvolveAdvisorTaskDetails
@@ -214,7 +213,6 @@ Database Management
     oci.database_management.models.EnableExternalDbSystemDatabaseManagementDetails
     oci.database_management.models.EnableExternalDbSystemStackMonitoringDetails
     oci.database_management.models.EnableExternalExadataInfrastructureManagementDetails
-    oci.database_management.models.EnableExternalMysqlAssociatedServiceDetails
     oci.database_management.models.EnableExternalNonContainerDatabaseManagementFeatureDetails
     oci.database_management.models.EnableExternalPluggableDatabaseManagementFeatureDetails
     oci.database_management.models.EnableHighFrequencyAutomaticSpmEvolveAdvisorTaskDetails

docs/api/database_management/models/oci.database_management.models.DisableExternalMysqlAssociatedServiceDetails.rst

@@ -153,6 +153,7 @@ API Reference
 * :doc:`Media Services <media_services/client/oci.media_services.MediaServicesClient>`
 * :doc:`Media Stream <media_services/client/oci.media_services.MediaStreamClient>`
 * :doc:`Migration <cloud_migrations/client/oci.cloud_migrations.MigrationClient>`
+* :doc:`Model Deployment <model_deployment/client/oci.model_deployment.ModelDeploymentClient>`
 * :doc:`Monitoring <monitoring/client/oci.monitoring.MonitoringClient>`
 * :doc:`Mysqlaas <mysql/client/oci.mysql.MysqlaasClient>`
 * :doc:`Network Firewall <network_firewall/client/oci.network_firewall.NetworkFirewallClient>`
@@ -377,6 +378,7 @@ API Reference
     marketplace_publisher
     media_services
     mngdmac
+    model_deployment
     monitoring
     mysql
     network_firewall

docs/api/database_management/models/oci.database_management.models.EnableExternalMysqlAssociatedServiceDetails.rst

@@ -0,0 +1,21 @@
+Model Deployment 
+================
+
+.. autosummary::
+    :toctree: model_deployment/client
+    :nosignatures:
+    :template: autosummary/service_client.rst
+
+    oci.model_deployment.ModelDeploymentClient
+    oci.model_deployment.ModelDeploymentClientCompositeOperations
+
+--------
+ Models
+--------
+
+.. autosummary::
+    :toctree: model_deployment/models
+    :nosignatures:
+    :template: autosummary/model_class.rst
+
+    oci.model_deployment.models.InferenceResult

docs/api/landing.rst

@@ -0,0 +1,8 @@
+ModelDeploymentClient
+=====================
+
+.. currentmodule:: oci.model_deployment
+
+.. autoclass:: ModelDeploymentClient
+    :special-members: __init__
+    :members:

docs/api/model_deployment.rst

@@ -0,0 +1,8 @@
+ModelDeploymentClientCompositeOperations
+========================================
+
+.. currentmodule:: oci.model_deployment
+
+.. autoclass:: ModelDeploymentClientCompositeOperations
+    :special-members: __init__
+    :members:

docs/api/model_deployment/client/oci.model_deployment.ModelDeploymentClient.rst

@@ -0,0 +1,11 @@
+InferenceResult
+===============
+
+.. currentmodule:: oci.model_deployment.models
+
+.. autoclass:: InferenceResult
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:

docs/api/model_deployment/client/oci.model_deployment.ModelDeploymentClientCompositeOperations.rst

@@ -64,6 +64,7 @@ Opensearch
     oci.opensearch.models.RestoreOpensearchClusterDetails
     oci.opensearch.models.ReverseConnectionEndpoint
     oci.opensearch.models.SecuritySamlConfig
+    oci.opensearch.models.ShapesDetails
     oci.opensearch.models.UpdateCheckinDetails
     oci.opensearch.models.UpdateClusterHardenedImageDetails
     oci.opensearch.models.UpdateClusterSpecsDetails

docs/api/model_deployment/models/oci.model_deployment.models.InferenceResult.rst

@@ -0,0 +1,11 @@
+ShapesDetails
+=============
+
+.. currentmodule:: oci.opensearch.models
+
+.. autoclass:: ShapesDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:

docs/api/opensearch.rst

@@ -0,0 +1,105 @@
+# OCI Agent Development Kit (ADK)
+
+OCI Agent Development Kit (ADK) is a client-side library that simplifies building agents on OCI Generative AI Agent Service, offering a developer experience (DX) comparable to other leading agent frameworks.
+
+Alternatively, you can also use the `GenerativeAiAgentClient` and `GenerativeAiAgentRuntimeClient` to directly interact with OCI Agent Service, but the ADK addon within the OCI SDK provides a much simpler way to build agents, especially when implementing custom function tools and agent orchestration.
+
+OCI Generative AI Agent Service official doc: 
+
+https://docs.oracle.com/en-us/iaas/Content/generative-ai-agents/home.htm
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.10+
+
+### Installation
+```bash
+pip install --upgrade "oci[adk]>=2.151.1"
+
+```
+
+### Authentication
+
+The ADK provides a `AgentClient` class to handle authentication and management of agent resources.
+Four types of authentication are supported:
+- `api_key`: API key authentication, Default authentication method
+- `instance_principal`: Instance principal authentication, recommended for OCI compute instances
+- `security_token`: Security token authentication, internal auth method for OCI developers
+- `resource_principal`: Resource principals authentication, recommended for OCI resources
+
+Most of the time, `api_key` is the best choice for authentication. Here is a doc on how to setup 
+API key and OCI config: 
+https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm
+
+For more details, please refer to OCI official authentication doc: https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm
+
+Sample AgentClient initiation with API key and Default profile. 
+The region is also required to automatically select the service endpoint.
+```python
+from oci.addons.adk import AgentClient
+
+client = AgentClient(
+    auth_type="api_key",
+    profile="DEFAULT",
+    region="us-chicago-1",  # airport code is also valid, i.e. "ORD"
+)
+```
+
+### Example
+```python
+from typing import Dict
+from oci.addons.adk import Agent, AgentClient, tool
+
+"""
+This example shows an agent with a single function tool.
+"""
+
+@tool
+def get_weather(location: str) -> Dict[str, str]:
+    """Get the weather for a given location"""
+    return {"location": location, "temperature": 72, "unit": "F"}
+
+
+def main():
+
+    # Use a custom agent client for custom profile settings
+    client = AgentClient(
+        auth_type="api_key",
+        profile="DEFAULT",
+        region="us-chicago-1",
+    )
+
+    # Instantiate the local agent object, with a single function tool (plain Python function)
+    agent = Agent(
+        client=client,
+        agent_endpoint_id="YOUR_AGENT_ENDPOINT_ID",
+        instructions="You are a helpful assistant that can perform weather queries.",
+        tools=[get_weather]
+    )
+
+    # Set up the agent once (which configures the instructions and tools in the remote agent resource)
+    agent.setup()
+
+    # Run the agent with an input
+    input = "Is it cold in Seattle?"
+    response = agent.run(input)
+
+    # Should print like "It's not cold in Seattle. The current temperature is 72 degrees Fahrenheit. "
+    response.pretty_print()
+
+if __name__ == "__main__":
+    main()
+```
+
+## Examples Directory Overview
+
+| Example | Description |
+|---------|-------------|
+| `single-agent-single-tool` | Minimal agent with single function tool |
+| `single-agent-multiple-tools` | Minimal agent with multiple function tools |
+| `multi-turn` | Minimal agent with multiple user turns |
+| `multi-agent` | Collaborative agents with workflow orchestration |
+| `deterministic-workflow` | Predictable execution patterns for business processes |
+| `lifecycle-hook` | Custom handlers for agent state transitions |

docs/api/opensearch/models/oci.opensearch.models.ShapesDetails.rst

@@ -0,0 +1,45 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from oci.addons.adk import Toolkit, tool
+from typing import Dict, Any
+
+
+class ResearcherToolkit(Toolkit):
+
+    @tool
+    def get_trending_keywords(self, topic: str) -> Dict[str, Any]:
+        """ Get the trending keywords for a given topic.
+
+        Args:
+            topic (str): The topic to get trending keywords for
+
+        Returns:
+            str: A JSON string containing the trending keywords
+        """
+
+        if topic == "ai":
+            return {"keywords": ["agent", "stargate", "openai", "oracle"]}
+
+        elif topic == "tiktok":
+            return {"keywords": ["tiktok", "trump", "elon", "larry"]}
+
+        else:
+            return {"keywords": ["oracle"]}
+
+
+class WriterToolkit(Toolkit):
+
+    @tool
+    def email_user(self, blog_post: str, user_email: str) -> str:
+        """ Email the writer with the blog post.
+
+        Args:
+            blog_post (str): The blog post to email to the user
+            user_email (str): The email address of the user to email the blog post to
+        Returns:
+            str: A message indicating that the email has been sent
+        """
+
+        return f"Email sent to user with blog post: {blog_post}"

examples/adk/README.md

@@ -0,0 +1,70 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from oci.addons.adk import Agent, AgentClient
+from custom_functon_tools import ResearcherToolkit, WriterToolkit
+
+"""
+This examples shows how you can build "deterministically orchestrated workflows with agentic steps".
+"""
+
+
+# Your (existing) vanilla python code to be integrated into this agentic workflow
+def get_user_preferences():
+    # Simulate result you fetched from DB
+    return {
+        "email": "[email protected]",
+        "style": ["casual", "humorous"],
+        "topics": ["ai"]
+    }
+
+
+def main():
+
+    client = AgentClient(
+        auth_type="security_token",
+        profile="BoatOc1",
+        region="kix"
+    )
+
+    researcher = Agent(
+        client=client,
+        agent_endpoint_id="ocid1.genaiagentendpoint.oc1.ap-osaka-1.amaaaaaacqy6p4qaos",
+        name="Researcher",
+        instructions="You are a researcher. You research trending keywords based on the user preferences.",
+        tools=[ResearcherToolkit()]
+    )
+
+    writer = Agent(
+        client=client,
+        agent_endpoint_id="ocid1.genaiagentendpoint.oc1.ap-osaka-1.amaaaaaacqy6p4qaqa6",
+        name="Writer",
+        instructions="You are a writer. You write a blog post based on the trending keywords and the user preferences.",
+        tools=[WriterToolkit()]
+    )
+
+    researcher.setup()
+    writer.setup()
+
+    # Step 1: fetch user preferences (non-agentic step), or any pre-processing
+    user_preferences = get_user_preferences()
+
+    # Step 2: research trending keywords (agentic step), using outputs from previous steps as input
+    topics = user_preferences['topics']
+    researcher_prompt = f"Research trending keywords for the following topics: {topics}"
+    last_run_response = researcher.run(researcher_prompt)
+
+    # Step 3: write a blog post (agentic step), using outputs from last two steps as input
+    keywords = last_run_response.output
+    style = user_preferences['style']
+    email = user_preferences['email']
+    writer_prompt = f"Write a 5 sentences blog post and email it to {email}. Use style: {style}. Blog post should be based on: {keywords}."
+    last_run_response = writer.run(writer_prompt)
+
+    # Step 4: do whatever you want with the last step output, here we just print it
+    last_run_response.pretty_print()
+
+
+if __name__ == "__main__":
+    main()