{
  "name": "customer-support-kb",
  "description": "Customer support knowledge base",
  "knowledgeSources": [
    {"name": "product-docs"},
    {"name": "support-articles"},
    {"name": "sharepoint-policies"}
  ],
  "llmConnection": {
    "resourceId": "/subscriptions/.../Microsoft.CognitiveServices/accounts/my-openai",
    "deploymentName": "gpt-4o"
  },
  "retrievalReasoningEffort": "low"
}

{
  "llmConnection": {
    "resourceId": "/subscriptions/{subscription}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{name}",
    "deploymentName": "gpt-4o"
  }
}

{
  "knowledgeSources": [
    {"name": "indexed-docs"},
    {"name": "remote-sharepoint"},
    {"name": "web-search"}
  ]
}

PUT https://{search-service}.search.windows.net/knowledgebases/{kb-name}?api-version=2025-11-01-preview
Content-Type: application/json
api-key: {admin-key}

{
  "name": "my-knowledge-base",
  "description": "Main knowledge base",
  "knowledgeSources": [
    {"name": "docs-source"}
  ],
  "llmConnection": {
    "resourceId": "{openai-resource-id}",
    "deploymentName": "gpt-4o"
  },
  "retrievalReasoningEffort": "low"
}

POST https://{search-service}.search.windows.net/knowledgebases/{kb-name}/retrieve?api-version=2025-11-01-preview
Content-Type: application/json
api-key: {admin-key}

{
  "query": "What is the return policy for electronics?",
  "messageHistory": [
    {
      "role": "user",
      "content": "I bought a laptop last week"
    },
    {
      "role": "assistant",
      "content": "I can help you with information about your laptop purchase"
    }
  ]
}

{
  "content": "Based on our return policy...",
  "references": [
    {
      "referenceId": "ref1",
      "title": "Electronics Return Policy",
      "snippet": "Electronics can be returned within 30 days..."
    }
  ],
  "activityLog": {
    "queryPlan": {
      "subqueries": [
        "electronics return policy",
        "laptop return timeframe"
      ]
    }
  }
}