関数呼び出しが平文に化けるとき、まず疑うのはツール宣言のプロパティ名です

# tool_bisect.py — どのツール宣言が平文化を誘発しているかを絞り込みます。
# 実行前に、失敗が安定して再現する入力を 1 つ用意しておきます（たまに出る状態では絞れません）。
import os
from google import genai
from google.genai import types
from my_tools import ALL_DECLARATIONS  # list[types.FunctionDeclaration]
 
client = genai.Client(api_key=os.environ.get("GEMINI_API_KEY", "YOUR_API_KEY"))
MODEL = "gemini-3.8-flash"
PROMPT = "新着の壁紙を 1 枚分類して、結果をカタログへ書き戻してください。"
 
 
def reproduces(subset):
    """subset だけを渡したときに、関数呼び出しが平文へ化けるかどうかを返します。"""
    resp = client.models.generate_content(
        model=MODEL,
        contents=PROMPT,
        config=types.GenerateContentConfig(
            tools=[types.Tool(function_declarations=subset)],
            # 上限を切り分けから外すため、十分に大きい値を明示しておきます。
            max_output_tokens=4096,
        ),
    )
    return str(resp.candidates[0].finish_reason).endswith("MALFORMED_FUNCTION_CALL")
 
 
def bisect(decls):
    """再現する側だけを残して、半分ずつ落としていきます。"""
    calls = 0
    while len(decls) > 1:
        half = len(decls) // 2
        left, right = decls[:half], decls[half:]
        calls += 1
        if reproduces(left):
            decls = left
            continue
        calls += 1
        if reproduces(right):
            decls = right
            continue
        print("片側だけでは再現しません。2 本の組み合わせを疑ってください。")
        break
    print("呼び出し回数:", calls)
    return decls
 
 
if __name__ == "__main__":
    suspects = bisect(list(ALL_DECLARATIONS))
    print("犯人候補:", [d.name for d in suspects])

{
  "name": "classify_palette",
  "parameters": {
    "type": "object",
    "properties": {
      "in": { "type": "string", "description": "分類する画像のパス" }
    },
    "required": ["in"]
  }
}

# 名前だけを変えた 2 通りを用意して、finishReason の違いを見ます。
BROKEN = {"name": "probe", "parameters": {"type": "object", "properties": {"in": {"type": "string"}}}}
FIXED = {"name": "probe", "parameters": {"type": "object", "properties": {"in_": {"type": "string"}}}}
print(list(BROKEN["parameters"]["properties"]), list(FIXED["parameters"]["properties"]))

# schema_lint.py — ツール宣言を渡す前に、危ない名前を見つけて止めます。
# 起動時と CI の両方から assert_clean() を呼びます。
import keyword
 
RESERVED = set(keyword.kwlist) | set(keyword.softkwlist) | {
    "self", "cls", "args", "kwargs", "type", "id", "input", "list", "dict", "object",
}
 
 
class SchemaNameError(ValueError):
    """ツール宣言のプロパティ名が予約語と衝突したときに送出します。"""
 
 
def walk(schema, path):
    """properties・items・$defs を再帰的に辿り、見つけた名前と経路を返します。"""
    if not isinstance(schema, dict):
        return
    for name, child in (schema.get("properties") or {}).items():
        yield name, path + [name]
        yield from walk(child, path + [name])
    items = schema.get("items")
    if items is not None:
        yield from walk(items, path + ["[]"])
    for key in ("$defs", "definitions"):
        for name, child in (schema.get(key) or {}).items():
            yield from walk(child, path + [key, name])
 
 
def lint(declarations):
    """違反を (ツール名, 経路, 名前) の形で列挙します。"""
    found = []
    for decl in declarations:
        for prop, path in walk(decl.get("parameters") or {}, []):
            if prop in RESERVED:
                found.append((decl["name"], ".".join(path), prop))
    return found
 
 
def assert_clean(declarations):
    """違反が 1 件でもあれば、その場で止めます。"""
    found = lint(declarations)
    if found:
        lines = ["  {}: {} が予約語 {} です".format(t, p, n) for t, p, n in found]
        raise SchemaNameError("ツール宣言に使えない名前があります\n" + "\n".join(lines))
 
 
if __name__ == "__main__":
    sample = [{
        "name": "search_catalog",
        "parameters": {
            "type": "object",
            "properties": {"in": {"type": "string"}, "limit": {"type": "integer"}},
        },
    }]
    try:
        assert_clean(sample)
    except SchemaNameError as err:
        print(err)