대화형 작업이 2023년 6월 13일에 지원 중단되었습니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
Storage
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
작업에서 사용자 환경을 더 잘 맞춤설정하려면 대화 차례 사이나 이 사용자와의 여러 대화에 데이터를 저장하면 됩니다.
저장된 데이터는 단일 대화에서 유용한 프롬프트를 제공하거나, 여러 세션에 걸쳐 게임 점수를 저장하거나, 사용자를 위한 작은 정보를 기억할 수 있습니다.
대화 중에 데이터를 다양한 방법으로 저장할 수 있습니다. 단일 대화에서 유형을 사용하여 인텐트의 학습 문구를 주석 처리하거나 슬롯 채우기 중에 사용자의 정보를 저장할 수 있습니다.
다음 저장 메서드와 함께 웹훅을 사용하여 작업 값을 저장할 수도 있습니다.
이러한 저장 메서드를 서로 조합하여 사용하면 작업 호출 내부에 또는 작업 호출 사이에 정보를 유지할 방법을 가장 잘 찾을 수 있습니다.
세션 저장소
한 대화에서 다른 대화로 값을 유지하지 않으려면 세션 저장소를 사용하세요. 대화 중에 유형을 사용하여 수집된 모든 데이터는 세션 스토리지에 저장됩니다.
사용자 스토리지
확인된 단일 사용자의 여러 대화에서 값을 유지하려면 사용자 저장소를 사용합니다. 예를 들어 게임은 사용자의 최고 점수를 사용자 저장소에 저장하고 사용자가 새 대화를 시작할 때마다 환영 메시지에 최고 점수를 표시할 수 있습니다.
가정용 저장용량
단일 가구에 있는 기기의 대화 간에 값을 유지하려면 홈 스토리지를 사용합니다 (Home Graph 기반). 홈 스토리지는 특정 사용자별로 지정되지 않으므로 가족 구성원 누구나 스토리지 사용에 기여할 수 있습니다. 홈 스토리지를 사용할 때 Google은 인증된 사용자에게 알림을 한 번 표시하고 게스트 사용자가 호출할 때마다 (10분마다 최대 한 번) 알림을 추가로 표시합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eActions on Google can save data to customize user experiences, enabling features like reprompts and storing information across conversations.\u003c/p\u003e\n"],["\u003cp\u003eData can be saved within a single conversation using types or across conversations with session, user, or home storage, depending on the desired persistence.\u003c/p\u003e\n"],["\u003cp\u003eSession storage retains data for a single conversation, user storage saves data for a specific user across conversations, and home storage persists data for all users on devices in a household.\u003c/p\u003e\n"]]],["Data in user interactions can be saved within single or multiple conversations to enhance user experience. Data can be stored through types in intents or via webhook storage methods: session storage for single conversation data, user storage for data across conversations of a specific user, and home storage for data across conversations for all users in a household. These methods can be used in conjunction to manage how information persists.\n"],null,["# Storage\n\nTo better customize a user's experience with your Action, you can save data\nbetween turns of a conversation or across multiple conversations with that user.\nSaved data can provide helpful reprompts in a single conversation, store game\nscores across sessions, or remember small pieces of information for a user.\n\nData can be stored in multiple ways during a conversation. In a single\nconversation, you can use [types](/assistant/conversational/types) to annotate training phrases in intents or\nto store information from the user during slot filling.\n\nYou can also have your Action store values using your webhook with the following\nstorage methods:\n\n- Session storage\n- User storage\n- Home storage\n\nUse these storage methods in combination with each other to best match how you\nwant to persist information within or between invocations of your Action.\n\nSession storage\n---------------\n\nUse [session storage](/assistant/conversational/storage-session) when you want to persist a value for a single\nconversation, but not from one conversation to another. During a conversation,\nany data collected using [types](/assistant/conversational/types) is stored in session storage.\n\nUser storage\n------------\n\nUse [user storage](/assistant/conversational/storage-user) when you want to persist a value across conversations for a\nsingle verified user. For example, a game can save a user's high score in user\nstorage and present the high score in the welcome message each time the user\nstarts a new conversation.\n\nHome storage\n------------\n\nUse [home storage](/assistant/conversational/storage-home) when you want to persist a value across conversations for\ndevices in a single household (based on [Home Graph](/assistant/smarthome/concepts/homegraph)). Home storage isn't\nspecific to any particular user, so any user in the household can contribute\ntowards it. When using home storage, Google additionally presents a notification\nonce to verified users, and on each invocation by guest users (up to once per 10\nminutes)."]]
