86 lines
3.0 KiB
Python
86 lines
3.0 KiB
Python
"""Shared contracts for platform-owned conversation system tools."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Iterable, Mapping
|
|
from typing import Any
|
|
|
|
|
|
SYSTEM_TOOL_SPECS: dict[str, dict[str, str]] = {
|
|
"end_conversation": {
|
|
"id": "tool_end_call_default",
|
|
"name": "结束对话",
|
|
"function_name": "end_conversation",
|
|
"description": (
|
|
"礼貌地结束本次对话。当用户明确告别、表示任务已完成"
|
|
"或要求挂断时调用。"
|
|
),
|
|
},
|
|
"update_state": {
|
|
"id": "tool_update_state_default",
|
|
"name": "更新状态",
|
|
"function_name": "update_state",
|
|
"description": (
|
|
"静默更新本次对话中已经声明并明确授权的动态变量。"
|
|
"只提交本轮获得或确认的信息，更新后继续当前回答。"
|
|
),
|
|
},
|
|
"skip_turn": {
|
|
"id": "tool_skip_turn_default",
|
|
"name": "跳过本轮",
|
|
"function_name": "skip_turn",
|
|
"description": (
|
|
"跳过当前轮次，不生成任何语音回复。"
|
|
"仅当用户明确要求稍等、话还没说完，或输入可确认只是噪音时调用。"
|
|
),
|
|
},
|
|
"request_human_handoff": {
|
|
"id": "tool_request_human_handoff_default",
|
|
"name": "转接人工",
|
|
"function_name": "request_human_handoff",
|
|
"description": (
|
|
"提交人工接管请求。当用户明确要求人工服务、投诉升级或 AI 无法"
|
|
"解决时调用。该工具只提交请求，不代表人工已经接通；调用后继续"
|
|
"回复用户并说明正在等待人工响应。"
|
|
),
|
|
},
|
|
}
|
|
|
|
SYSTEM_TOOL_KINDS = frozenset(SYSTEM_TOOL_SPECS)
|
|
|
|
|
|
def system_tool_kind(definition: Mapping[str, Any] | None) -> str | None:
|
|
"""Return the supported platform behavior declared by a System resource."""
|
|
config = (definition or {}).get("config")
|
|
if not isinstance(config, Mapping):
|
|
return None
|
|
kind = str(config.get("kind") or "")
|
|
return kind if kind in SYSTEM_TOOL_KINDS else None
|
|
|
|
|
|
def state_update_properties(
|
|
definitions: Mapping[str, Mapping[str, Any]] | None,
|
|
*,
|
|
allowed_names: Iterable[str] | None = None,
|
|
) -> dict[str, dict[str, Any]]:
|
|
"""Build an explicit LLM schema for writable declared variables."""
|
|
definitions = definitions or {}
|
|
names = (
|
|
list(dict.fromkeys(str(name) for name in allowed_names))
|
|
if allowed_names is not None
|
|
else list(definitions)
|
|
)
|
|
properties: dict[str, dict[str, Any]] = {}
|
|
for name in names:
|
|
definition = definitions.get(name)
|
|
if not isinstance(definition, Mapping):
|
|
continue
|
|
variable_type = str(definition.get("type") or "string")
|
|
if variable_type not in {"string", "number", "boolean"}:
|
|
continue
|
|
properties[name] = {
|
|
"type": variable_type,
|
|
"description": f"更新动态变量 {name}。",
|
|
}
|
|
return properties
|