프로젝트의 포드를 설치하거나 업데이트한 후 포드를 사용하여 Xcode 프로젝트를 엽니다.
.xcworkspace ML Kit는 Xcode 버전 12.4 이상에서 지원됩니다.
1. 대화 기록 객체 만들기
스마트 답장을 생성하려면 ML Kit에 시간순으로 정렬된
TextMessage 객체(가장 오래된 타임스탬프가 먼저 표시됨) 사용자가
메시지를 보내거나 받고, 메시지, 타임스탬프, 메시지 추가
대화 기록에 추가합니다.
사용자 ID는
있습니다. 사용자 ID가 사용자 데이터와 일치하지 않아도 되므로
대화나 대화 간에 사용자 ID가 일관되지 않아도 됩니다.
스마트 회신 생성기의 호출을 포함합니다.
답장을 추천하려는 사용자가 보낸 메시지인 경우 다음과 같이 설정합니다.
isLocalUser를 true로 설정합니다.
Swift
varconversation:[TextMessage]=[]// Then, for each message sent and received:letmessage=TextMessage(text:"How are you?",timestamp:Date().timeIntervalSince1970,userID:"userId",isLocalUser:false)conversation.append(message)
Objective-C
NSMutableArray*conversation=[NSMutableArrayarray];// Then, for each message sent and received:MLKTextMessage*message=[[MLKTextMessagealloc]initWithText:@"How are you?"timestamp:[NSDatedate].timeIntervalSince1970userID:userIdisLocalUser:NO];[conversationaddObject:message];
대화 기록 객체의 예시는 다음과 같습니다.
타임스탬프
userID
isLocalUser
메시지
2019년 2월 21일 목요일 13:13:39 PST
true
가는 중인가요?
2019년 2월 21일 목요일 13:15:03 PST
FRIEND0
거짓
너무 늦었어요, 죄송합니다!
ML Kit는 대화 기록의 마지막 메시지에 대한 답장을 제안합니다. 마지막 메시지
로컬에 있지 않은 사용자가 보낸 것이어야 합니다. 위의 예에서는 대화의 마지막 메일이
은 로컬 사용자가 아닌 사용자 FRIEND0에게 있습니다. 이 로그를 통과하는 ML Kit를 사용하면
FRIENDO의 메시지에 대한 답장: "늦었어, 죄송합니다!"
2. 메시지 답장 받기
메시지에 대한 스마트 답장을 생성하려면 SmartReply의 인스턴스를 가져와 다음을 전달합니다.
대화 기록을 suggestReplies(for:completion:) 메서드에 전달합니다.
Swift
SmartReply.smartReply().suggestReplies(for:conversation){result,erroringuarderror==nil,letresult=resultelse{return}if(result.status==.notSupportedLanguage){// The conversation's language isn't supported, so// the result doesn't contain any suggestions.}elseif(result.status==.success){// Successfully suggested smart replies.// ...}}
Objective-C
MLKSmartReply*smartReply=[MLKSmartReplysmartReply];[smartReplysuggestRepliesForMessages:inputTextcompletion:^(MLKSmartReplySuggestionResult*_Nullableresult,NSError*_Nullableerror){if(error||!result){return;}if(result.status==MLKSmartReplyResultStatusNotSupportedLanguage){// The conversation's language isn't supported, so// the result doesn't contain any suggestions.}elseif(result.status==MLKSmartReplyResultStatusSuccess){// Successfully suggested smart replies.// ...}}];
작업이 성공하면 SmartReplySuggestionResult 객체가
완료 핸들러에 전달합니다. 이 객체에는 제안되는 키워드 목록(최대 3개)이 포함됩니다.
사용자에게 표시할 수 있는 다음 답글:
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eML Kit provides an on-device model to generate smart replies for messages in English conversations, enhancing user experience and engagement.\u003c/p\u003e\n"],["\u003cp\u003eBy passing a conversation history to ML Kit, developers can receive up to three suggested replies for the latest message, which can then be displayed to the user.\u003c/p\u003e\n"],["\u003cp\u003eBefore utilizing the API, ensure the device is 64-bit and include the necessary ML Kit pods in your project.\u003c/p\u003e\n"],["\u003cp\u003eThe smart reply feature is optimized for non-sensitive conversations, and may not generate results if the language is unsupported or sensitive topics are detected.\u003c/p\u003e\n"]]],[],null,["ML Kit can generate short replies to messages using an on-device model.\n\nTo generate smart replies, you pass ML Kit a log of recent messages in a\nconversation. If ML Kit determines the conversation is in English, and that\nthe conversation doesn't have potentially sensitive subject matter, ML Kit\ngenerates up to three replies, which you can suggest to your user.\n\n\u003cbr /\u003e\n\n| **Note:** ML Kit iOS APIs only run on 64-bit devices. If you build your app with 32-bit support, check the device's architecture before using this API.\n\nTry it out\n\n- Play around with [the sample app](https://github.com/googlesamples/mlkit/tree/master/ios/quickstarts/smartreply) to see an example usage of this API.\n\nBefore you begin\n\n1. Include the following ML Kit pods in your Podfile: \n\n ```\n pod 'GoogleMLKit/SmartReply', '8.0.0'\n ```\n2. After you install or update your project's Pods, open your Xcode project using its `.xcworkspace`. ML Kit is supported in Xcode version 12.4 or greater.\n\n1. Create a conversation history object\n\nTo generate smart replies, you pass ML Kit a chronologically-ordered array of\n`TextMessage` objects, with the earliest timestamp first. Whenever the user\nsends or receives a message, add the message, its timestamp, and the message\nsender's user ID to the conversation history.\n\nThe user ID can be any string that uniquely identifies the sender within the\nconversation. The user ID doesn't need to correspond to any user data,\nand the user ID doesn't need to be consistent between conversations or\ninvocations of the smart reply generator.\n\nIf the message was sent by the user you want to suggest replies to, set\n`isLocalUser` to true. \n\nSwift \n\n```swift\nvar conversation: [TextMessage] = []\n\n// Then, for each message sent and received:\nlet message = TextMessage(\n text: \"How are you?\",\n timestamp: Date().timeIntervalSince1970,\n userID: \"userId\",\n isLocalUser: false)\nconversation.append(message)\n```\n\nObjective-C \n\n```objective-c\nNSMutableArray *conversation = [NSMutableArray array];\n\n// Then, for each message sent and received:\nMLKTextMessage *message = [[MLKTextMessage alloc]\n initWithText:@\"How are you?\"\n timestamp:[NSDate date].timeIntervalSince1970\n userID:userId\n isLocalUser:NO];\n[conversation addObject:message];\n```\n\nA conversation history object looks like the following example:\n\n| Timestamp | userID | isLocalUser | Message |\n|------------------------------|---------|-------------|----------------------|\n| Thu Feb 21 13:13:39 PST 2019 | | true | are you on your way? |\n| Thu Feb 21 13:15:03 PST 2019 | FRIEND0 | false | Running late, sorry! |\n\nML Kit suggests replies to the last message in a conversation history. The last message\nshould be from a non-local user. In the example above, the last message in the conversation\nis from the non-local user FRIEND0. When you use pass ML Kit this log, it suggests\nreplies to FRIENDO's message: \"Running late, sorry!\"\n\n2. Get message replies\n\nTo generate smart replies to a message, get an instance of `SmartReply` and pass\nthe conversation history to its `suggestReplies(for:completion:)` method: \n\nSwift \n\n```swift\nSmartReply.smartReply().suggestReplies(for: conversation) { result, error in\n guard error == nil, let result = result else {\n return\n }\n if (result.status == .notSupportedLanguage) {\n // The conversation's language isn't supported, so\n // the result doesn't contain any suggestions.\n } else if (result.status == .success) {\n // Successfully suggested smart replies.\n // ...\n }\n}\n```\n\nObjective-C \n\n```objective-c\nMLKSmartReply *smartReply = [MLKSmartReply smartReply];\n[smartReply suggestRepliesForMessages:inputText\n completion:^(MLKSmartReplySuggestionResult * _Nullable result,\n NSError * _Nullable error) {\n if (error || !result) {\n return;\n }\n if (result.status == MLKSmartReplyResultStatusNotSupportedLanguage) {\n // The conversation's language isn't supported, so\n // the result doesn't contain any suggestions.\n } else if (result.status == MLKSmartReplyResultStatusSuccess) {\n // Successfully suggested smart replies.\n // ...\n }\n}];\n```\n\nIf the operation succeeds, a `SmartReplySuggestionResult` object is passed to\nthe completion handler. This object contains a list of up to three suggested\nreplies, which you can present to your user: \n\nSwift \n\n```swift\nfor suggestion in result.suggestions {\n print(\"Suggested reply: \\(suggestion.text)\")\n}\n```\n\nObjective-C \n\n```objective-c\nfor (MLKSmartReplySuggestion *suggestion in result.suggestions) {\n NSLog(@\"Suggested reply: %@\", suggestion.text);\n}\n```\n\nNote that ML Kit might not return results if the model isn't confident in\nthe relevance of the suggested replies, the input conversation isn't in\nEnglish, or if the model detects sensitive subject matter."]]