Skip to main content
Version: 1.1

utcp_client_implementation

File: core/src/utcp/implementations/utcp_client_implementation.py

class UtcpClientImplementation (UtcpClient)​

No class documentation available

Methods:​

async create(cls, root_dir: Optional[str], config: Optional[Union[str, Dict[str, Any], UtcpClientConfig]]) -> 'UtcpClient'

Create a new [UtcpClient](./../utcp_client.md#utcpclient) instance.

Args

  • root_dir: The root directory for the client.
  • config: The configuration for the client.

Returns

A new [UtcpClient](./../utcp_client.md#utcpclient) instance.

async register_manual(self, manual_call_template: CallTemplate) -> RegisterManualResult

Register a manual in the client.

Registers a manual and its tools with the client. During registration, tools are

Filtered Based On The Manual'S Allowed_Communication_Protocols Setting

  • If allowed_communication_protocols is set to a non-empty list, only tools using protocols in that list are registered.
  • If allowed_communication_protocols is None or empty, it defaults to only allowing the manual's own call_template_type. This provides secure-by-default behavior.

Tools that don't match the allowed protocols are excluded from registration and a warning is logged for each excluded tool.

Args

  • manual_call_template: The [CallTemplate](./../data/call_template.md#calltemplate) instance representing the manual to register.

Returns

A [RegisterManualResult](./../data/register_manual_response.md#registermanualresult) instance containing the registered tools (filtered by allowed protocols) and any errors encountered.

Raises

  • ValueError: If manual name is already registered or communication protocol is not found.
async register_manuals(self, manual_call_templates: List[CallTemplate]) -> List[RegisterManualResult]

Register multiple manuals in the client.

Args

  • manual_call_templates: A list of [CallTemplate](./../data/call_template.md#calltemplate) instances representing the manuals to register.

Returns

A list of [RegisterManualResult](./../data/register_manual_response.md#registermanualresult) instances representing the results of the registration.

async deregister_manual(self, manual_name: str) -> bool

Deregister a manual from the client.

Args

  • manual_name: The name of the manual to deregister.

Returns

A boolean indicating whether the manual was successfully deregistered.

async call_tool(self, tool_name: str, tool_args: Dict[str, Any]) -> Any

Call a tool in the client.

Executes a registered tool with the provided arguments. Before execution, validates that the tool's communication protocol is allowed by the parent manual's

Allowed_Communication_Protocols Setting

  • If allowed_communication_protocols is set to a non-empty list, the tool's protocol must be in that list.
  • If allowed_communication_protocols is None or empty, only tools using the manual's own call_template_type are allowed.

Args

  • tool_name: The fully qualified name of the tool (e.g., "manual_name.tool_name").
  • tool_args: A dictionary of arguments to pass to the tool.

Returns

The result of the tool call, after any post-processing.

Raises

  • ValueError: If the tool is not found or if the tool's communication protocol is not in the manual's allowed protocols.
async call_tool_streaming(self, tool_name: str, tool_args: Dict[str, Any]) -> AsyncGenerator[Any, None]

Call a tool in the client with streaming response.

Executes a registered tool with streaming output. Before execution, validates that the tool's communication protocol is allowed by the parent manual's

Allowed_Communication_Protocols Setting

  • If allowed_communication_protocols is set to a non-empty list, the tool's protocol must be in that list.
  • If allowed_communication_protocols is None or empty, only tools using the manual's own call_template_type are allowed.

Args

  • tool_name: The fully qualified name of the tool (e.g., "manual_name.tool_name").
  • tool_args: A dictionary of arguments to pass to the tool.

Yields

Chunks of the tool's streaming response, after any post-processing.

Raises

  • ValueError: If the tool is not found or if the tool's communication protocol is not in the manual's allowed protocols.
async search_tools(self, query: str, limit: int, any_of_tags_required: Optional[List[str]]) -> List[Tool]

Search for tools based on the given query.

Args

  • query: The query to search for.
  • limit: The maximum number of results to return.
  • any_of_tags_required: A list of tags that must be present in the tool.

Returns

A list of tools that match the query.

async get_required_variables_for_manual_and_tools(self, manual_call_template: CallTemplate) -> List[str]

Get the required variables for a manual and its tools.

Args

  • manual_call_template: The [CallTemplate](./../data/call_template.md#calltemplate) instance representing the manual.

Returns

A list of required variables for the manual and its tools.

async get_required_variables_for_registered_tool(self, tool_name: str) -> List[str]

Get the required variables for a registered tool.

Args

  • tool_name: The name of the tool.

Returns

A list of required variables for the tool.