{"files":{"SKILL.md":"---\nname: qnamaker-client\ndescription: \"QnAMaker Client API skill. Use when working with QnAMaker Client for endpointSettings, endpointkeys, alterations. Covers 15 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# QnAMaker Client\nAPI version: 4.0\n\n## Auth\nApiKey Ocp-Apim-Subscription-Key in header\n\n## Base URL\nNot specified.\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /endpointSettings -- gets endpoint settings for an endpoint.\n3. POST /knowledgebases/{kbId} -- create first knowledgebase\n\n## Endpoints\n15 endpoints across 5 groups. See references/api-spec.lap for full details.\n\n### EndpointSettings\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /endpointSettings | Gets endpoint settings for an endpoint. |\n| PATCH | /endpointSettings | Updates endpoint settings for an endpoint. |\n\n### Endpointkeys\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /endpointkeys | Gets endpoint keys for an endpoint |\n| PATCH | /endpointkeys/{keyType} | Re-generates an endpoint key. |\n\n### Alterations\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /alterations | Download alterations from runtime. |\n| PUT | /alterations | Replace alterations data. |\n\n### Knowledgebases\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /knowledgebases | Gets all knowledgebases for a user. |\n| GET | /knowledgebases/{kbId} | Gets details of a specific knowledgebase. |\n| DELETE | /knowledgebases/{kbId} | Deletes the knowledgebase and all its data. |\n| POST | /knowledgebases/{kbId} | Publishes all changes in test index of a knowledgebase to its prod index. |\n| PUT | /knowledgebases/{kbId} | Replace knowledgebase contents. |\n| PATCH | /knowledgebases/{kbId} | Asynchronous operation to modify a knowledgebase. |\n| POST | /knowledgebases/create | Asynchronous operation to create a new knowledgebase. |\n| GET | /knowledgebases/{kbId}/{environment}/qna | Download the knowledgebase. |\n\n### Operations\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /operations/{operationId} | Gets details of a specific long running operation. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all endpointSettings?\" -> GET /endpointSettings\n- \"List all endpointkeys?\" -> GET /endpointkeys\n- \"Partially update a endpointkey?\" -> PATCH /endpointkeys/{keyType}\n- \"List all alterations?\" -> GET /alterations\n- \"List all knowledgebases?\" -> GET /knowledgebases\n- \"Get operation details?\" -> GET /operations/{operationId}\n- \"Get knowledgebase details?\" -> GET /knowledgebases/{kbId}\n- \"Delete a knowledgebase?\" -> DELETE /knowledgebases/{kbId}\n- \"Update a knowledgebase?\" -> PUT /knowledgebases/{kbId}\n- \"Partially update a knowledgebase?\" -> PATCH /knowledgebases/{kbId}\n- \"Create a create?\" -> POST /knowledgebases/create\n- \"List all qna?\" -> GET /knowledgebases/{kbId}/{environment}/qna\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api QnAMaker Client\n@version 4.0\n@auth ApiKey Ocp-Apim-Subscription-Key in header\n@endpoints 15\n@toc endpointSettings(2), endpointkeys(2), alterations(2), knowledgebases(8), operations(1)\n\n@group endpointSettings\n@endpoint GET /endpointSettings\n@desc Gets endpoint settings for an endpoint.\n@returns(200) Response with endpoint settings info in it.\n\n@endpoint PATCH /endpointSettings\n@desc Updates endpoint settings for an endpoint.\n@required {endpointSettingsPayload: map # Post body of the request.}\n@returns(204) HTTP 204 No Content.\n\n@endgroup\n\n@group endpointkeys\n@endpoint GET /endpointkeys\n@desc Gets endpoint keys for an endpoint\n@returns(200) Response with endpoint info in it.\n\n@endpoint PATCH /endpointkeys/{keyType}\n@desc Re-generates an endpoint key.\n@required {keyType: any # Type of Key}\n@returns(200) Details of the endpoint keys generated.\n\n@endgroup\n\n@group alterations\n@endpoint GET /alterations\n@desc Download alterations from runtime.\n@returns(200) Alterations data.\n\n@endpoint PUT /alterations\n@desc Replace alterations data.\n@required {wordAlterations: map # New alterations data.}\n@returns(204) HTTP 204 No Content.\n\n@endgroup\n\n@group knowledgebases\n@endpoint GET /knowledgebases\n@desc Gets all knowledgebases for a user.\n@returns(200) Collection of knowledgebases.\n\n@endgroup\n\n@group operations\n@endpoint GET /operations/{operationId}\n@desc Gets details of a specific long running operation.\n@required {operationId: any # Operation id.}\n@returns(200) Details of the long running operation.\n\n@endgroup\n\n@group knowledgebases\n@endpoint GET /knowledgebases/{kbId}\n@desc Gets details of a specific knowledgebase.\n@required {kbId: any # Knowledgebase id.}\n@returns(200) Details of the knowledgebase.\n\n@endpoint DELETE /knowledgebases/{kbId}\n@desc Deletes the knowledgebase and all its data.\n@required {kbId: any # Knowledgebase id.}\n@returns(204) HTTP 204 No content.\n\n@endpoint POST /knowledgebases/{kbId}\n@desc Publishes all changes in test index of a knowledgebase to its prod index.\n@required {kbId: any # Knowledgebase id.}\n@returns(204) HTTP 204 No content.\n\n@endpoint PUT /knowledgebases/{kbId}\n@desc Replace knowledgebase contents.\n@required {kbId: any # Knowledgebase id., replaceKb: map # An instance of ReplaceKbDTO which contains list of qnas to be uploaded}\n@returns(204) HTTP 204 No content.\n\n@endpoint PATCH /knowledgebases/{kbId}\n@desc Asynchronous operation to modify a knowledgebase.\n@required {kbId: any # Knowledgebase id., updateKb: map # Post body of the request.}\n@returns(202) Details of the asynchronous operation.\n\n@endpoint POST /knowledgebases/create\n@desc Asynchronous operation to create a new knowledgebase.\n@required {createKbPayload: map # Post body of the request.}\n@returns(202) Details of the asynchronous operation.\n\n@endpoint GET /knowledgebases/{kbId}/{environment}/qna\n@desc Download the knowledgebase.\n@required {kbId: any # Knowledgebase id., environment: any # Specifies whether environment is Test or Prod.}\n@optional {source: any # The source property filter to apply. Sample value: Editorial, smartLight%20FAQ.tsv ., changedSince: any # changedSince property is used to return all QnAs created or updated after a specific time duration. The user can filter QnAs by seconds (s), minutes (m), hours (h) and days (d). The user may use any integral value along with the suffix for time. For instance, the value of 5m returns all QnA pairs updated or created in the last 5 minutes.}\n@returns(200) Collection of all Q-A in the knowledgebase.\n\n@endgroup\n\n@end\n"}}