docs: [google-ai-generativelanguage] Update summary, improve description for title in EmbedContentRequest (#12219)

BEGIN_COMMIT_OVERRIDE
fix!: Fix content.proto's Schema - `type` should be required
feat: Update GenAI libraries to include input_safety_feedback
docs: Minor docs updates
docs: Update summary, improve description for `title` in
`EmbedContentRequest`
END_COMMIT_OVERRIDE


- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 600858110

Source-Link:
googleapis/googleapis@50e09cc

Source-Link:
googleapis/googleapis-gen@f5d8bb9
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWFpLWdlbmVyYXRpdmVsYW5ndWFnZS8uT3dsQm90LnlhbWwiLCJoIjoiZjVkOGJiOTAzMGM3NDEzNzEyMGU2MTgyMjRlNDU5OTM4MWZlZmEzNyJ9

BEGIN_NESTED_COMMIT


PiperOrigin-RevId: 600837712

Source-Link:
googleapis/googleapis@d99f6f5

Source-Link:
googleapis/googleapis-gen@4be94d5
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWFpLWdlbmVyYXRpdmVsYW5ndWFnZS8uT3dsQm90LnlhbWwiLCJoIjoiNGJlOTRkNTcwNWJkZTEwYzVhOTlhNzU0ZjVhM2E3YmZhMjE1MDllOCJ9
END_NESTED_COMMIT

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>

Author: gcf-owl-bot[bot]

packages/google-ai-generativelanguage/google/ai/generativelanguage/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.4.1"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.4.1"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1/types/generative_service.py

@@ -442,6 +442,9 @@ class EmbedContentRequest(proto.Message):
             Optional. An optional title for the text. Only applicable
             when TaskType is ``RETRIEVAL_DOCUMENT``.
 
+            Note: Specifying a ``title`` for ``RETRIEVAL_DOCUMENT``
+            provides better quality embeddings for retrieval.
+
             This field is a member of `oneof`_ ``_title``.
     """
 

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.4.1"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/services/generative_service/async_client.py

@@ -426,6 +426,9 @@ async def sample_generate_answer():
                 the last ``Content`` in the list containing the
                 question.
 
+                Note: GenerateAnswer currently only supports queries in
+                English.
+
                 This corresponds to the ``contents`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/services/generative_service/client.py

@@ -638,6 +638,9 @@ def sample_generate_answer():
                 the last ``Content`` in the list containing the
                 question.
 
+                Note: GenerateAnswer currently only supports queries in
+                English.
+
                 This corresponds to the ``contents`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/types/content.py

@@ -339,10 +339,10 @@ class Schema(proto.Message):
 
     Attributes:
         type_ (google.ai.generativelanguage_v1beta.types.Type):
-            Optional. Data type.
+            Required. Data type.
         format_ (str):
             Optional. The format of the data. This is
-            used obnly for primative datatypes. Supported
+            used only for primitive datatypes. Supported
             formats:
 
              for NUMBER type: float, double

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/types/generative_service.py

@@ -636,6 +636,9 @@ class GenerateAnswerRequest(proto.Message):
             answer. For multi-turn queries, this is a repeated field
             that contains conversation history and the last ``Content``
             in the list containing the question.
+
+            Note: GenerateAnswer currently only supports queries in
+            English.
         answer_style (google.ai.generativelanguage_v1beta.types.GenerateAnswerRequest.AnswerStyle):
             Required. Style in which answers should be
             returned.
@@ -757,8 +760,72 @@ class GenerateAnswerResponse(proto.Message):
                cases. 0.5 is a good starting threshold.
 
             This field is a member of `oneof`_ ``_answerable_probability``.
+        input_feedback (google.ai.generativelanguage_v1beta.types.GenerateAnswerResponse.InputFeedback):
+            Output only. Feedback related to the input data used to
+            answer the question, as opposed to model-generated response
+            to the question.
+
+            "Input data" can be one or more of the following:
+
+            -  Question specified by the last entry in
+               ``GenerateAnswerRequest.content``
+            -  Conversation history specified by the other entries in
+               ``GenerateAnswerRequest.content``
+            -  Grounding sources
+               (``GenerateAnswerRequest.semantic_retriever`` or
+               ``GenerateAnswerRequest.inline_passages``)
+
+            This field is a member of `oneof`_ ``_input_feedback``.
     """
 
+    class InputFeedback(proto.Message):
+        r"""Feedback related to the input data used to answer the
+        question, as opposed to model-generated response to the
+        question.
+
+
+        .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
+        Attributes:
+            block_reason (google.ai.generativelanguage_v1beta.types.GenerateAnswerResponse.InputFeedback.BlockReason):
+                Optional. If set, the input was blocked and
+                no candidates are returned. Rephrase your input.
+
+                This field is a member of `oneof`_ ``_block_reason``.
+            safety_ratings (MutableSequence[google.ai.generativelanguage_v1beta.types.SafetyRating]):
+                Ratings for safety of the input.
+                There is at most one rating per category.
+        """
+
+        class BlockReason(proto.Enum):
+            r"""Specifies what was the reason why input was blocked.
+
+            Values:
+                BLOCK_REASON_UNSPECIFIED (0):
+                    Default value. This value is unused.
+                SAFETY (1):
+                    Input was blocked due to safety reasons. You can inspect
+                    ``safety_ratings`` to understand which safety category
+                    blocked it.
+                OTHER (2):
+                    Input was blocked due to other reasons.
+            """
+            BLOCK_REASON_UNSPECIFIED = 0
+            SAFETY = 1
+            OTHER = 2
+
+        block_reason: "GenerateAnswerResponse.InputFeedback.BlockReason" = proto.Field(
+            proto.ENUM,
+            number=1,
+            optional=True,
+            enum="GenerateAnswerResponse.InputFeedback.BlockReason",
+        )
+        safety_ratings: MutableSequence[safety.SafetyRating] = proto.RepeatedField(
+            proto.MESSAGE,
+            number=2,
+            message=safety.SafetyRating,
+        )
+
     answer: "Candidate" = proto.Field(
         proto.MESSAGE,
         number=1,
@@ -769,6 +836,12 @@ class GenerateAnswerResponse(proto.Message):
         number=2,
         optional=True,
     )
+    input_feedback: InputFeedback = proto.Field(
+        proto.MESSAGE,
+        number=3,
+        optional=True,
+        message=InputFeedback,
+    )
 
 
 class EmbedContentRequest(proto.Message):
@@ -797,6 +870,9 @@ class EmbedContentRequest(proto.Message):
             Optional. An optional title for the text. Only applicable
             when TaskType is ``RETRIEVAL_DOCUMENT``.
 
+            Note: Specifying a ``title`` for ``RETRIEVAL_DOCUMENT``
+            provides better quality embeddings for retrieval.
+
             This field is a member of `oneof`_ ``_title``.
     """
 

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/types/retriever.py

@@ -50,7 +50,7 @@ class Corpus(proto.Message):
             Example: ``corpora/my-awesome-corpora-123a456b789c``
         display_name (str):
             Optional. The human-readable display name for the
-            ``Corpus``. The display name must be no more than 128
+            ``Corpus``. The display name must be no more than 512
             characters in length, including spaces. Example: "Docs on
             Semantic Retriever".
         create_time (google.protobuf.timestamp_pb2.Timestamp):

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/types/tuned_model.py

@@ -333,8 +333,7 @@ class Dataset(proto.Message):
 
 
 class TuningExamples(proto.Message):
-    r"""A set of tuning examples. Can be training or validatation
-    data.
+    r"""A set of tuning examples. Can be training or validation data.
 
     Attributes:
         examples (MutableSequence[google.ai.generativelanguage_v1beta.types.TuningExample]):