118 lines
5.0 KiB
Python
118 lines
5.0 KiB
Python
# Copyright (c) Microsoft. All rights reserved.
|
|
|
|
from typing import Any
|
|
|
|
from semantic_kernel.connectors.ai.function_call_choice_configuration import FunctionCallChoiceConfiguration
|
|
from semantic_kernel.contents.function_call_content import FunctionCallContent
|
|
from semantic_kernel.contents.function_result_content import FunctionResultContent
|
|
from semantic_kernel.functions.kernel_function_metadata import KernelFunctionMetadata
|
|
from semantic_kernel.functions.kernel_parameter_metadata import KernelParameterMetadata
|
|
|
|
|
|
def kernel_function_to_bedrock_function_schema(
|
|
function_choice_configuration: FunctionCallChoiceConfiguration,
|
|
) -> dict[str, Any]:
|
|
"""Convert the kernel function to bedrock function schema."""
|
|
return {
|
|
"functions": [
|
|
kernel_function_metadata_to_bedrock_function_schema(function_metadata)
|
|
for function_metadata in function_choice_configuration.available_functions or []
|
|
]
|
|
}
|
|
|
|
|
|
def kernel_function_metadata_to_bedrock_function_schema(function_metadata: KernelFunctionMetadata) -> dict[str, Any]:
|
|
"""Convert the kernel function metadata to bedrock function schema."""
|
|
schema = {
|
|
"description": function_metadata.description,
|
|
"name": function_metadata.fully_qualified_name,
|
|
"parameters": {
|
|
parameter.name: kernel_function_parameter_to_bedrock_function_parameter(parameter)
|
|
for parameter in function_metadata.parameters
|
|
},
|
|
# This field controls whether user confirmation is required to invoke the function.
|
|
# If this is set to "ENABLED", the user will be prompted to confirm the function invocation.
|
|
# Only after the user confirms, the function call request will be issued by the agent.
|
|
# If the user denies the confirmation, the agent will act as if the function does not exist.
|
|
# Currently, we do not support this feature, so we set it to "DISABLED".
|
|
"requireConfirmation": "DISABLED",
|
|
}
|
|
|
|
# Remove None values from the schema
|
|
return {key: value for key, value in schema.items() if value is not None}
|
|
|
|
|
|
def kernel_function_parameter_to_bedrock_function_parameter(parameter: KernelParameterMetadata):
|
|
"""Convert the kernel function parameters to bedrock function parameters."""
|
|
schema = {
|
|
"description": parameter.description,
|
|
"type": kernel_function_parameter_type_to_bedrock_function_parameter_type(parameter.schema_data),
|
|
"required": parameter.is_required,
|
|
}
|
|
|
|
# Remove None values from the schema
|
|
return {key: value for key, value in schema.items() if value is not None}
|
|
|
|
|
|
# These are the allowed parameter types in bedrock function.
|
|
# https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ParameterDetail.html
|
|
BEDROCK_FUNCTION_ALLOWED_PARAMETER_TYPES = {
|
|
"string",
|
|
"number",
|
|
"integer",
|
|
"boolean",
|
|
"array",
|
|
}
|
|
|
|
|
|
def kernel_function_parameter_type_to_bedrock_function_parameter_type(schema_data: dict[str, Any] | None) -> str:
|
|
"""Convert the kernel function parameter type to bedrock function parameter type."""
|
|
if schema_data is None:
|
|
raise ValueError(
|
|
"Schema data is required to convert the kernel function parameter type to bedrock function parameter type."
|
|
)
|
|
|
|
type_ = schema_data.get("type")
|
|
if type_ is None:
|
|
raise ValueError(
|
|
"Type is required to convert the kernel function parameter type to bedrock function parameter type."
|
|
)
|
|
|
|
if type_ not in BEDROCK_FUNCTION_ALLOWED_PARAMETER_TYPES:
|
|
raise ValueError(
|
|
f"Type {type_} is not allowed in bedrock function parameter type. "
|
|
f"Allowed types are {BEDROCK_FUNCTION_ALLOWED_PARAMETER_TYPES}."
|
|
)
|
|
|
|
return type_
|
|
|
|
|
|
def parse_return_control_payload(return_control_payload: dict[str, Any]) -> list[FunctionCallContent]:
|
|
"""Parse the return control payload to a list of function call contents for the kernel."""
|
|
return [
|
|
FunctionCallContent(
|
|
id=return_control_payload["invocationId"],
|
|
name=invocation_input["functionInvocationInput"]["function"],
|
|
arguments={
|
|
parameter["name"]: parameter["value"]
|
|
for parameter in invocation_input["functionInvocationInput"]["parameters"]
|
|
},
|
|
metadata=invocation_input,
|
|
)
|
|
for invocation_input in return_control_payload.get("invocationInputs", [])
|
|
]
|
|
|
|
|
|
def parse_function_result_contents(function_result_contents: list[FunctionResultContent]) -> list[dict[str, Any]]:
|
|
"""Parse the function result contents to be returned to the agent in the session state."""
|
|
return [
|
|
{
|
|
"functionResult": {
|
|
"actionGroup": function_result_content.metadata["functionInvocationInput"]["actionGroup"],
|
|
"function": function_result_content.name,
|
|
"responseBody": {"TEXT": {"body": str(function_result_content.result)}},
|
|
}
|
|
}
|
|
for function_result_content in function_result_contents
|
|
]
|