{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Certified Answers"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"certified-answers","__idx":0},"children":["Certified Answers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certified Answers"]}," are business curated, verified and trusted, question and answer pairs such as FAQs or important procedures."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certified Answers ensure ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["trustworthy, consistent, and auditable"]}," responses by returning only vetted content authored and approved by the enterprise. When a Certified Answer is retrieved, it provides a complete, source-grounded response rather than a generated one."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":1},"children":["How It Works"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Article Filtering"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any article type can be configured to use with Certified Answers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Articles to be used with Certified Answers should be authored in the following structured format:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The title represents the question (e.g., “What are loans?”)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The article content serves as the Certified Answer."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This ensures only trusted, purpose-authored FAQs are considered for Certified Answer retrieval."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Semantic Search"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["semantic search"]}," is performed over the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Title"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Related Questions"]}," metadata fields of the filtered FAQ articles."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Relevance Scoring & Threshold Evaluation"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All Certified Answer type articles are scored based on semantic similarity to the user query."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the top result’s similarity score meets or exceeds the configured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certifiedAnswerThreshold"]},", the corresponding article content is returned as the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certified Answer"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any other FAQ articles that also meet the threshold are included in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["searchResults"]},"."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fallback to Generative"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If no FAQ articles meet the Certified Answer threshold, the API falls back to a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["generative"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hybrid search"]}," approach."]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-certified-answers-matter","__idx":2},"children":["Why Certified Answers Matter"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Unlike generative AI responses, which are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["probabilistic and can sometimes hallucinate"]},", Certified Answers guarantee that the response is grounded in actual source content."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["traceability and compliance"]}," for regulated industries such as finance, healthcare, and legal."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request","__idx":3},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  'https://<API_DOMAIN>/core/aiservices/v4/PROD-1000/answers?q=mortgage%20requirements&%24lang=en-US' \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer <ACCESS_TOKEN>\"\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-response","__idx":4},"children":["Example Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a Certified Answer is given, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["answer"]}," object will be returned in the response and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["answerType"]}," will be 'certified'."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"answer\": {\n    \"answerValue\": \"To apply for a mortgage, you need proof of income, credit history, and identification documents.\",\n    \"references\": [\n      {\n        \"id\": \"PROD-11223\",\n        \"name\": \"Mortgage Application Guide\",\n        \"source\": \"eGain Article\",\n        \"docType\": \"HTML\",\n        \"topicBreadcrumb\": [\n          {\n            \"topicSummary\": [\n              {\n                \"id\": \"PROD-5268\",\n                \"name\": \"Mortgages\"\n              }\n            ]\n          }\n        ]\n      }\n    ],\n    \"answerType\": \"certified\",\n    \"relevanceScore\": 0.99\n  },\n  \"searchResults\": [\n    {\n      \"id\": \"PROD-11223\",\n      \"name\": \"Mortgage Application Guide\",\n      \"source\": \"eGain Article\",\n      \"snippet\": \"To apply for a mortgage, you need proof of income, credit history, and identification documents.\",\n      \"snippetType\": \"articleContent\",\n      \"relevanceScore\": 0.99,\n      \"topicBreadcrumb\": [\n        {\n          \"topicSummary\": [\n            {\n              \"id\": \"PROD-5268\",\n              \"name\": \"Mortgages\"\n            }\n          ]\n        }\n      ]\n    }\n  ],\n  \"sessionId\": \"eb24df84-50d7-4321-b699-d9b03bbe5696\"\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Certified Answers","id":"certified-answers","depth":1},{"value":"How It Works","id":"how-it-works","depth":2},{"value":"Why Certified Answers Matter","id":"why-certified-answers-matter","depth":2},{"value":"Example Request","id":"example-request","depth":2},{"value":"Example Response","id":"example-response","depth":2}],"frontmatter":{"seo":{"title":"Certified Answers"}},"lastModified":"2026-02-24T01:38:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-portal/guides/answer/answers_certified","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}