99 lines
2.9 KiB
Python
99 lines
2.9 KiB
Python
# Copyright 2025 Google LLC
|
|
#
|
|
# Licensed 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.
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Optional
|
|
|
|
from google.genai import types
|
|
from pydantic import BaseModel
|
|
from pydantic import ConfigDict
|
|
from pydantic import Field
|
|
|
|
from ..tools.base_tool import BaseTool
|
|
|
|
|
|
class LlmRequest(BaseModel):
|
|
"""LLM request class that allows passing in tools, output schema and system
|
|
|
|
instructions to the model.
|
|
|
|
Attributes:
|
|
model: The model name.
|
|
contents: The contents to send to the model.
|
|
config: Additional config for the generate content request.
|
|
tools_dict: The tools dictionary.
|
|
"""
|
|
|
|
model_config = ConfigDict(arbitrary_types_allowed=True)
|
|
"""The model config."""
|
|
|
|
model: Optional[str] = None
|
|
"""The model name."""
|
|
|
|
contents: list[types.Content] = Field(default_factory=list)
|
|
"""The contents to send to the model."""
|
|
|
|
config: Optional[types.GenerateContentConfig] = None
|
|
live_connect_config: types.LiveConnectConfig = types.LiveConnectConfig()
|
|
"""Additional config for the generate content request.
|
|
|
|
tools in generate_content_config should not be set.
|
|
"""
|
|
tools_dict: dict[str, BaseTool] = Field(default_factory=dict, exclude=True)
|
|
"""The tools dictionary."""
|
|
|
|
def append_instructions(self, instructions: list[str]) -> None:
|
|
"""Appends instructions to the system instruction.
|
|
|
|
Args:
|
|
instructions: The instructions to append.
|
|
"""
|
|
|
|
if self.config.system_instruction:
|
|
self.config.system_instruction += '\n\n' + '\n\n'.join(instructions)
|
|
else:
|
|
self.config.system_instruction = '\n\n'.join(instructions)
|
|
|
|
def append_tools(self, tools: list[BaseTool]) -> None:
|
|
"""Appends tools to the request.
|
|
|
|
Args:
|
|
tools: The tools to append.
|
|
"""
|
|
|
|
if not tools:
|
|
return
|
|
declarations = []
|
|
for tool in tools:
|
|
if isinstance(tool, BaseTool):
|
|
declaration = tool._get_declaration()
|
|
else:
|
|
declaration = tool.get_declaration()
|
|
if declaration:
|
|
declarations.append(declaration)
|
|
self.tools_dict[tool.name] = tool
|
|
if declarations:
|
|
self.config.tools.append(types.Tool(function_declarations=declarations))
|
|
|
|
def set_output_schema(self, base_model: type[BaseModel]) -> None:
|
|
"""Sets the output schema for the request.
|
|
|
|
Args:
|
|
base_model: The pydantic base model to set the output schema to.
|
|
"""
|
|
|
|
self.config.response_schema = base_model
|
|
self.config.response_mime_type = 'application/json'
|