{"files":{"SKILL.md":"---\nname: personalizer-client\ndescription: \"Personalizer Client API skill. Use when working with Personalizer Client for configurations, evaluations, events. Covers 17 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Personalizer Client\nAPI version: v1.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 /configurations/service -- get service configuration.\n3. POST /evaluations -- create first evaluation\n\n## Endpoints\n17 endpoints across 6 groups. See references/api-spec.lap for full details.\n\n### Configurations\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /configurations/service | Get Service Configuration. |\n| PUT | /configurations/service | Update Service Configuration. |\n| GET | /configurations/policy | Get Policy. |\n| PUT | /configurations/policy | Update Policy. |\n| DELETE | /configurations/policy | Reset Policy. |\n\n### Evaluations\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /evaluations/{evaluationId} | Get Evaluation. |\n| DELETE | /evaluations/{evaluationId} | Delete Evaluation. |\n| GET | /evaluations | List Evaluations. |\n| POST | /evaluations | Create Evaluation. |\n\n### Events\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /events/{eventId}/reward | Post Reward. |\n| POST | /events/{eventId}/activate | Activate Event. |\n\n### Logs\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /logs | Deletes Logs. |\n| GET | /logs/properties | Get Log Properties. |\n\n### Model\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /model | Get Model. |\n| DELETE | /model | Reset Model. |\n| GET | /model/properties | Get Model Properties. |\n\n### Rank\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /rank | Post Rank. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all service?\" -> GET /configurations/service\n- \"List all policy?\" -> GET /configurations/policy\n- \"Get evaluation details?\" -> GET /evaluations/{evaluationId}\n- \"Delete a evaluation?\" -> DELETE /evaluations/{evaluationId}\n- \"List all evaluations?\" -> GET /evaluations\n- \"Create a evaluation?\" -> POST /evaluations\n- \"Create a reward?\" -> POST /events/{eventId}/reward\n- \"Create a activate?\" -> POST /events/{eventId}/activate\n- \"List all properties?\" -> GET /logs/properties\n- \"List all model?\" -> GET /model\n- \"Create a rank?\" -> POST /rank\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 Personalizer Client\n@version v1.0\n@auth ApiKey Ocp-Apim-Subscription-Key in header\n@endpoints 17\n@toc configurations(5), evaluations(4), events(2), logs(2), model(3), rank(1)\n\n@group configurations\n@endpoint GET /configurations/service\n@desc Get Service Configuration.\n@returns(200) Success\n\n@endpoint PUT /configurations/service\n@desc Update Service Configuration.\n@required {config: map # The personalizer service configuration.}\n@returns(200) Success\n\n@endpoint GET /configurations/policy\n@desc Get Policy.\n@returns(200) Success\n\n@endpoint PUT /configurations/policy\n@desc Update Policy.\n@required {policy: map # The Learning settings.}\n@returns(200) Success\n\n@endpoint DELETE /configurations/policy\n@desc Reset Policy.\n@returns(200) Success\n\n@endgroup\n\n@group evaluations\n@endpoint GET /evaluations/{evaluationId}\n@desc Get Evaluation.\n@required {evaluationId: any # Id of the evaluation.}\n@returns(200) Success\n\n@endpoint DELETE /evaluations/{evaluationId}\n@desc Delete Evaluation.\n@required {evaluationId: any # Id of the evaluation to delete.}\n@returns(204) Success\n\n@endpoint GET /evaluations\n@desc List Evaluations.\n@returns(200) Success\n\n@endpoint POST /evaluations\n@desc Create Evaluation.\n@required {evaluation: map # The evaluation job definition.}\n@returns(201) Success\n\n@endgroup\n\n@group events\n@endpoint POST /events/{eventId}/reward\n@desc Post Reward.\n@required {eventId: any # The event id this reward applies to., reward: map # The reward should be a floating point number, typically between 0 and 1.}\n@returns(204) Success\n\n@endpoint POST /events/{eventId}/activate\n@desc Activate Event.\n@required {eventId: any # The event ID this activation applies to.}\n@returns(204) Success\n\n@endgroup\n\n@group logs\n@endpoint DELETE /logs\n@desc Deletes Logs.\n@returns(204) Success\n\n@endpoint GET /logs/properties\n@desc Get Log Properties.\n@returns(200) Success\n\n@endgroup\n\n@group model\n@endpoint GET /model\n@desc Get Model.\n@returns(200) Success\n\n@endpoint DELETE /model\n@desc Reset Model.\n@returns(204) Success\n\n@endpoint GET /model/properties\n@desc Get Model Properties.\n@returns(200) Success\n\n@endgroup\n\n@group rank\n@endpoint POST /rank\n@desc Post Rank.\n@required {rankRequest: map # A Personalizer request.}\n@returns(201) Success\n\n@endgroup\n\n@end\n"}}