from azure.ai.projects.models import FunctionTool

search_tool = FunctionTool(
    name="search_knowledge",
    description=(
        "学習用 IT 手順を検索します。query は VPN Windows のように、"
        "少数のキーワードを空白で区切って指定してください。"
    ),
    parameters={
        "type": "object",
        "properties": {
            "query": {"type": "string", "description": "検索キーワード"}
        },
        "required": ["query"],
        "additionalProperties": False,
    },
    strict=True,
)

from dataclasses import dataclass


@dataclass(frozen=True)
class Document:
    document_id: str
    title: str
    passage: str
    source: str
    allowed_groups: frozenset[str]


DOCUMENTS = (
    Document(
        "vpn-windows",
        "Windows の VPN 確認手順",
        "学習用手順: Windows では接続先とエラー表示を確認します。",
        "https://kb.example.invalid/vpn-windows",
        frozenset({"employees"}),
    ),
    Document(
        "vpn-macos",
        "macOS の VPN 確認手順",
        "学習用手順: macOS では接続状態とエラー表示を確認します。",
        "https://kb.example.invalid/vpn-macos",
        frozenset({"employees"}),
    ),
    Document(
        "vpn-admin",
        "VPN 管理者向け手順",
        "学習用の管理者専用資料です。一般社員向けには返しません。",
        "https://kb.example.invalid/vpn-admin",
        frozenset({"admins"}),
    ),
)


def search_knowledge(
    query: str, *, user_groups: frozenset[str]
) -> list[dict[str, str]]:
    if not isinstance(query, str) or not query.strip() or len(query) > 200:
        raise ValueError("query must be a non-empty string of at most 200 characters")
    if not user_groups:
        raise PermissionError("Trusted user groups are required")

    terms = query.casefold().split()
    hits = []
    for document in DOCUMENTS:
        if not document.allowed_groups.intersection(user_groups):
            continue
        searchable = f"{document.title} {document.passage}".casefold()
        if all(term in searchable for term in terms):
            hits.append(
                {
                    "document_id": document.document_id,
                    "title": document.title,
                    "passage": document.passage,
                    "source": document.source,
                }
            )
    return hits

応答を受け取る
関数要求がなければ、最終的な出力を確認する
関数要求があれば、許可された関数名かを確認する
JSON を読み、必須項目・型・余計な項目を検証する
アプリが保持する利用者の文脈で関数を実行する
要求ごとの call_id と結果を、同じ会話へ返す
次の応答を受け取り、上限付きで繰り返す

from knowledge import search_knowledge

groups = frozenset({"employees"})
hits = search_knowledge("VPN Windows", user_groups=groups)
assert [hit["document_id"] for hit in hits] == ["vpn-windows"]
assert search_knowledge("VPN 管理者", user_groups=groups) == []
assert search_knowledge("存在しない製品", user_groups=groups) == []