{"files":{"SKILL.md":"---\nname: text-analytics-client\ndescription: \"Text Analytics Client API skill. Use when working with Text Analytics Client for keyPhrases, languages, sentiment. Covers 4 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Text Analytics Client\nAPI version: v2.1-preview\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. Verify API access with a test request\n3. POST /keyPhrases -- create first keyPhrase\n\n## Endpoints\n4 endpoints across 4 groups. See references/api-spec.lap for full details.\n\n### KeyPhrases\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /keyPhrases | The API returns a list of strings denoting the key talking points in the input text. |\n\n### Languages\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /languages | The API returns the detected language and a numeric score between 0 and 1. |\n\n### Sentiment\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /sentiment | The API returns a numeric score between 0 and 1. |\n\n### Entities\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /entities | The API returns a list of recognized entities in a given document. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a keyPhrase?\" -> POST /keyPhrases\n- \"Create a language?\" -> POST /languages\n- \"Create a sentiment?\" -> POST /sentiment\n- \"Create a entity?\" -> POST /entities\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 Text Analytics Client\n@version v2.1-preview\n@auth ApiKey Ocp-Apim-Subscription-Key in header\n@endpoints 4\n@toc keyPhrases(1), languages(1), sentiment(1), entities(1)\n\n@group keyPhrases\n@endpoint POST /keyPhrases\n@desc The API returns a list of strings denoting the key talking points in the input text.\n@required {input: map # Collection of documents to analyze. Documents can now contain a language field to indicate the text language}\n@returns(200) A successful response results in 0 or more key phrases identified in each valid document\n\n@endgroup\n\n@group languages\n@endpoint POST /languages\n@desc The API returns the detected language and a numeric score between 0 and 1.\n@required {input: map # Collection of documents to analyze.}\n@returns(200) A successful call results in the detected language with the highest probability for each valid document\n\n@endgroup\n\n@group sentiment\n@endpoint POST /sentiment\n@desc The API returns a numeric score between 0 and 1.\n@required {input: map # Collection of documents to analyze.}\n@returns(200) A successful call results in each valid document getting a sentiment score between 0 and 1\n\n@endgroup\n\n@group entities\n@endpoint POST /entities\n@desc The API returns a list of recognized entities in a given document.\n@required {input: map # Collection of documents to analyze.}\n@returns(200) A successful call results in a list of recognized entities returned for each valid document\n\n@endgroup\n\n@end\n"}}