TypedDict

TypedDict는 dict의 key와 value 타입을 타입 힌트로 선언하는 방법이다.

런타임 객체는 그냥 dict지만, 타입 체커와 IDE가 어떤 key가 있는지 알 수 있다.

예

Python
from typing import TypedDict

class WorkflowAgentState(TypedDict):
    user_request: str
    metadata: list[dict]
    actions: list[dict]

Python

total=False면 모든 key가 선택값이 된다. 응답 payload처럼 일부 필드만 채울 수 있는 dict에 좋다.

LangGraph State는 노드 간에 주고받는 dict이다. TypedDict를 쓰면 state의 필드 구조를 코드로 문서화할 수 있다.

TypedDict는 dict를 그대로 쓰면서 key 구조를 타입으로 설명하는 방법이다.

TypedDict는 dict의 key와 value 타입을 타입 힌트로 선언하는 방법이다.

런타임 객체는 그냥 dict지만, 타입 체커와 IDE가 어떤 key가 있는지 알 수 있다.

Python
from typing import TypedDict

class WorkflowAgentState(TypedDict):
    user_request: str
    metadata: list[dict]
    actions: list[dict]

Python
class WorkflowResponse(TypedDict, total=False):
    message: str
    actions: list[dict]

total=False면 모든 key가 선택값이 된다. 응답 payload처럼 일부 필드만 채울 수 있는 dict에 좋다.

LangGraph State는 노드 간에 주고받는 dict이다. TypedDict를 쓰면 state의 필드 구조를 코드로 문서화할 수 있다.

TypedDict는 dict를 그대로 쓰면서 key 구조를 타입으로 설명하는 방법이다.