Gets suggested articles for a participant based on specific historical messages.
Note that suggestions.list will only list the auto-generated suggestions, while suggestions.compile will try to compile suggestion based on the provided conversation context in the real time.
HTTP request
POST https://{endpoint}/v2beta1/{parent=projects/*/conversations/*/participants/*}/suggestions:suggestArticles
Required. The name of the participant to fetch suggestion for. Format: projects/<Project ID>/locations/<Location
ID>/conversations/<Conversation ID>/participants/<Participant ID>.
Authorization requires the following IAM permission on the specified resource parent:
dialogflow.suggestions.list
Request body
The request body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis API endpoint, \u003ccode\u003esuggestions:suggestArticles\u003c/code\u003e, retrieves suggested articles for a participant based on their historical messages.\u003c/p\u003e\n"],["\u003cp\u003eThe request uses a \u003ccode\u003ePOST\u003c/code\u003e method to a specific endpoint and requires a \u003ccode\u003eparent\u003c/code\u003e path parameter specifying the participant's name in a defined format.\u003c/p\u003e\n"],["\u003cp\u003eThe request body can include \u003ccode\u003elatestMessage\u003c/code\u003e, \u003ccode\u003econtextSize\u003c/code\u003e, and \u003ccode\u003eassistQueryParams\u003c/code\u003e to tailor the article suggestions.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns an instance of \u003ccode\u003eSuggestArticlesResponse\u003c/code\u003e, providing the list of article suggestions.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]