rawwar commented on code in PR #37287: URL: https://github.com/apache/airflow/pull/37287#discussion_r1484823816
########## airflow/providers/google/cloud/hooks/vertex_ai/generative_model.py: ########## @@ -0,0 +1,128 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +"""This module contains a Google Cloud Vertex AI Generative AI Model hooks.""" + +from __future__ import annotations + +from typing import Sequence + +from vertexai.language_models import TextGenerationModel +from vertexai.preview.generative_models import ChatSession, GenerativeModel + +from airflow.providers.google.common.hooks.base_google import GoogleBaseHook + + +class LanguageModelHook(GoogleBaseHook): + """Hook for Google Cloud Vertex AI Language Model APIs.""" + + def __init__( + self, + gcp_conn_id: str = "google_cloud_default", + impersonation_chain: str | Sequence[str] | None = None, + **kwargs, + ): + if kwargs.get("delegate_to") is not None: + raise RuntimeError( + "The `delegate_to` parameter has been deprecated before and finally removed in this version" + " of Google Provider. You MUST convert it to `impersonate_chain`" + ) + super().__init__(gcp_conn_id=gcp_conn_id, impersonation_chain=impersonation_chain, **kwargs) + + def generate_text( + self, + prompt: str, + pretrained_model: str, + temperature: float, + max_output_tokens: int, + top_p: float, + top_k: int, + ) -> str: + """ + Uses the Vertex AI PaLM API to generate natural language text. + + :param prompt: Required. Inputs or queries that a user or a program gives + to the Vertex AI PaLM API, in order to elicit a specific response. + :param pretrained_model: A pretrained_model optimized for performing natural + language tasks such as classification, summarization, extraction, content + creation, and ideation. + :param temperature: Temperature controls the degree of randomness in token + selection. + :param max_output_tokens: Token limit determines the maximum amount of text + output. + :param top_p: Tokens are selected from most probable to least until the sum + of their probabilities equals the top_p value. Defaults to 0.8. + :param top_k: A top_k of 1 means the selected token is the most probable + among all tokens. + """ + + parameters = { + "temperature": temperature, + "max_output_tokens": max_output_tokens, + "top_p": top_p, + "top_k": top_k, + } + + model = TextGenerationModel.from_pretrained(pretrained_model) + + response = model.predict( + prompt, + **parameters, + ) + return response.text + + +class MultimodalModelHook(GoogleBaseHook): + """Hook for Google Cloud Vertex AI Multimodal Model APIs.""" + + def __init__( + self, + gcp_conn_id: str = "google_cloud_default", + impersonation_chain: str | Sequence[str] | None = None, + **kwargs, + ): + if kwargs.get("delegate_to") is not None: + raise RuntimeError( + "The `delegate_to` parameter has been deprecated before and finally removed in this version" + " of Google Provider. You MUST convert it to `impersonate_chain`" + ) + super().__init__(gcp_conn_id=gcp_conn_id, impersonation_chain=impersonation_chain, **kwargs) + + def chat_prompt_request( + self, prompt: str, chat: ChatSession | None = None, pretrained_model: str = "gemini-pro" + ) -> str: + """ + Uses the Vertex AI Gemini Pro foundation model to generate natural language text. Review Comment: ```suggestion Use the Vertex AI Gemini Pro foundation model to generate natural language text. ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
