[Cognitive Services Text Analytics API ] API Review

[azure-sdk]

New API Review meeting has been requested.

Service Name: Cognitive Services Text Analytics API Review Created By: Aurgho Bhattacharjee Review Date: 10/17/2024 04:00 PM PT Release Plan: PR: Hero Scenarios Link: Not Provided Core Concepts Doc Link: Not Provided

Description: GA api for analyze-text. NER: Metadata, tags type to be GAd without breaking customers. PII: promote exclusion list in text pii to GA. Not promoting redaction character. Language Detection : promote script code feature to GA. GA Auto Language Detection

Detailed meeting information and documents provided can be accessed here For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[azure-sdk]

Meeting updated by Aurgho Bhattacharjee

Service Name: Cognitive Services Text Analytics API Review Created By: Aurgho Bhattacharjee Review Date: 10/24/2024 08:00 AM PT Release Plan: PR: Hero Scenarios Link: Not Provided Core Concepts Doc Link: Not Provided

Description: GA api for analyze-text. NER: Metadata, tags type to be GAd without breaking customers. PII: promote exclusion list in text pii to GA. Not promoting redaction character. Language Detection : promote script code feature to GA. Summarization : Change query parameter to prompt in abstractive summarization Healthcare: GA of temporal assertions and FHIR.

Detailed meeting information and documents provided can be accessed here For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[azure-sdk]

Meeting updated by Aurgho Bhattacharjee

Service Name: Cognitive Services Text Analytics API Review Created By: Aurgho Bhattacharjee Review Date: 10/24/2024 08:00 AM PT Release Plan: PR: https://github.com/Azure/azure-rest-api-specs/pull/31088 Hero Scenarios Link: Not Provided Core Concepts Doc Link: Not Provided

Description: This meeting was originally a place-holder for pending discussions for analyze-text and new analyze-document api changes

New preview API for analyze -document

Detailed meeting information and documents provided can be accessed here For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[mikekistler]

Notes from API Review 10/24/2024

• For the source and target in documents, consider using a different "kind" for Blob vs Container
• If the API accepts a "Folder", then you should include additional information or even input fields to specify separator characters, etc. See our BYOS guidance in the Azure API Guidelines.
• Also, consider change the property name based on "kind" -- not just "location"
• Long-running operations should conform to our guidelines
  • Use the TypeSpec standard operations -- to fall into the pit of success
  • Follow-up with the TypeSpec team if there are any issues there

This API is good for preview. Any of the above that can be fixed in this version, please do so. The remainder can be deferred to the next version but should be addressed before GA.