getMutableAIState — 서버에서 AI 상태 수정

getMutableAIState — 서버에서 AI 상태 수정

getMutableAIState는 AI 상태의 변경 가능한(mutable) 복사본을 가져오는 함수예요. 이를 사용해 서버 쪽에서 상태를 업데이트할 수 있어요.

주의: AI SDK RSC는 현재 실험적(experimental)이에요. 프로덕션에서는 AI SDK UI를 사용하는 걸 권장해요. RSC에서 UI로 마이그레이션하는 방법은 마이그레이션 가이드를 참고하세요.

출처: 문서

본문

AI 상태의 변경 가능한 복사본을 가져와요. 이를 사용해 서버 쪽에서 상태를 업데이트할 수 있어요.

Import

import { getMutableAIState } from "@ai-sdk/rsc"

API 시그니처

파라미터

  • key: string — AI 상태가 객체라면, 지정한 키의 값을 반환해요 (선택).

반환값

변경 가능한 AI 상태.

메서드

  • update: (newState: any) => void — AI 상태를 새 상태로 업데이트해요.
  • done: (newState: any) => void — AI 상태를 새 상태로 업데이트하고, 최종 확정하며 스트림을 닫아요.

예시

더 알아보기 (Learn more)

  • getAIState — 현재 AI 상태 읽기
  • useAIState — React 훅으로 AI 상태 읽기·업데이트