Files
wehub-resource-sync b957a53def
CodeQL / Analyze (csharp) (push) Waiting to run
CodeQL / Analyze (python) (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 13:21:23 +08:00

136 lines
5.6 KiB
Python

# Copyright (c) Microsoft. All rights reserved.
import logging
from copy import deepcopy
from typing import Any
from semantic_kernel.connectors.ai.function_choice_behavior import FunctionChoiceType
from semantic_kernel.const import DEFAULT_FULLY_QUALIFIED_NAME_SEPARATOR
from semantic_kernel.contents.chat_history import ChatHistory
from semantic_kernel.contents.utils.author_role import AuthorRole
from semantic_kernel.exceptions.service_exceptions import ServiceInvalidRequestError
logger: logging.Logger = logging.getLogger(__name__)
def filter_system_message(chat_history: ChatHistory) -> str | None:
"""Filter the first system message from the chat history.
If there are multiple system messages, raise an error.
If there are no system messages, return None.
"""
if len([message for message in chat_history if message.role == AuthorRole.SYSTEM]) > 1:
raise ServiceInvalidRequestError(
"Multiple system messages in chat history. Only one system message is expected."
)
for message in chat_history:
if message.role == AuthorRole.SYSTEM:
return message.content
return None
FUNCTION_CHOICE_TYPE_TO_GOOGLE_FUNCTION_CALLING_MODE = {
FunctionChoiceType.AUTO: "AUTO",
FunctionChoiceType.NONE: "NONE",
FunctionChoiceType.REQUIRED: "ANY",
}
# The separator used in the fully qualified name of the function instead of the default "-" separator.
# This is required since Gemini doesn't work well with "-" in the function name.
# https://ai.google.dev/gemini-api/docs/function-calling#function_declarations
# Using double underscore to avoid situations where the function name already contains a single underscore.
# For example, we may incorrect split a function name with a single score when the function doesn't have a plugin name.
GEMINI_FUNCTION_NAME_SEPARATOR = "__"
def format_gemini_function_name_to_kernel_function_fully_qualified_name(gemini_function_name: str) -> str:
"""Format the Gemini function name to the kernel function fully qualified name."""
if GEMINI_FUNCTION_NAME_SEPARATOR in gemini_function_name:
plugin_name, function_name = gemini_function_name.split(GEMINI_FUNCTION_NAME_SEPARATOR, 1)
return f"{plugin_name}{DEFAULT_FULLY_QUALIFIED_NAME_SEPARATOR}{function_name}"
return gemini_function_name
def sanitize_schema_for_google_ai(schema: dict[str, Any] | None) -> dict[str, Any] | None:
"""Sanitize a JSON schema dict so it is compatible with Google AI / Vertex AI.
The Google AI protobuf ``Schema`` does not support ``anyOf``, ``oneOf``, or
``allOf``. It also does not accept ``type`` as an array (e.g.
``["string", "null"]``). This helper recursively rewrites those constructs
into the subset that Google AI understands, using ``nullable`` where
appropriate.
"""
if schema is None:
return None
schema = deepcopy(schema)
return _sanitize_node(schema)
def _sanitize_node(node: dict[str, Any]) -> dict[str, Any]:
"""Recursively sanitize a single schema node."""
# --- handle ``type`` given as a list (e.g. ["string", "null"]) ---
type_val = node.get("type")
if isinstance(type_val, list):
non_null = [t for t in type_val if t != "null"]
if len(type_val) != len(non_null):
node["nullable"] = True
node["type"] = non_null[0] if non_null else "string"
# --- handle ``anyOf`` / ``oneOf`` / ``allOf`` ---
for key in ("anyOf", "oneOf", "allOf"):
variants = node.get(key)
if not variants:
continue
non_null = [v for v in variants if v.get("type") != "null"]
has_null = len(variants) != len(non_null)
chosen = _sanitize_node(non_null[0]) if non_null else {"type": "string"}
# Preserve description from the outer node
desc = node.get("description")
node.clear()
node.update(chosen)
if has_null:
node["nullable"] = True
if desc and "description" not in node:
node["description"] = desc
break # only process the first matching key
# --- recurse into nested structures ---
props = node.get("properties")
if isinstance(props, dict):
for prop_name, prop_schema in props.items():
if isinstance(prop_schema, dict):
props[prop_name] = _sanitize_node(prop_schema)
items = node.get("items")
if isinstance(items, dict):
node["items"] = _sanitize_node(items)
return node
def collapse_function_call_results_in_chat_history(chat_history: ChatHistory):
"""The Gemini API expects the results of parallel function calls to be contained in a single message to be returned.
This helper method collapses the results of parallel function calls in the chat history into a single Tool message.
Since this method in an internal method that is supposed to be called only by the Google AI and Vertex AI
connectors, it is safe to assume that the chat history contains a correct sequence of messages, i.e. there won't be
cases where the assistant wants to call 2 functions in parallel but there are more than 2 function results following
the assistant message.
"""
if not chat_history.messages:
return
current_idx = 1
while current_idx < len(chat_history):
previous_message = chat_history[current_idx - 1]
current_message = chat_history[current_idx]
if previous_message.role == AuthorRole.TOOL and current_message.role == AuthorRole.TOOL:
previous_message.items.extend(current_message.items)
chat_history.remove_message(current_message)
else:
current_idx += 1