Added support for attributes in DBMS_CLOUD_AI.generate

Author: aosingh

doc/source/user_guide/actions.rst

@@ -57,6 +57,21 @@ The following actions can be performed using ``select_ai``:
 Action methods
 ==============
 
+Request-specific profile attributes can be supplied with the optional
+``attributes`` mapping. For example, override ``additional_instructions`` for
+a single chat request:
+
+.. code-block:: python
+
+   response = profile.chat(
+       prompt="Write sample Python code to build and test a regression model",
+       attributes={
+           "additional_instructions": (
+               "Return executable code as plain text without Markdown fences."
+           )
+       },
+   )
+
 .. list-table:: Action to method mapping
    :header-rows: 1
    :widths: 30 35 35

doc/source/user_guide/profile_attributes.rst

@@ -74,6 +74,9 @@ Attribute groups
      - Tunes model generation behavior.
    * - ``conversation``
      - Enables conversation history for context-aware chat workflows.
+   * - ``additional_instructions``
+     - Provides persistent guidance, business rules, or response constraints
+       for requests that use the profile.
    * - ``source_language``, ``target_language``
      - Set default languages for ``Profile.translate()`` and
        ``AsyncProfile.translate()``. If no source language is configured or
@@ -134,5 +137,22 @@ responses:
        stop_tokens='[";"]',
    )
 
+Additional instructions
+=======================
+
+Use ``additional_instructions`` for guidance that should apply to every
+request made with a profile:
+
+.. code-block:: python
+
+   attributes = select_ai.ProfileAttributes(
+       provider=provider,
+       credential_name="my_oci_ai_profile_key",
+       additional_instructions="Return concise, executable Python code.",
+   )
+
+For guidance that applies to only one request, pass an ``attributes`` mapping
+to an action method instead of changing the saved profile.
+
 .. autoclass:: select_ai.ProfileAttributes
    :members: