writer edits

Author: PatrickFarley

articles/ai-services/content-safety/concepts/protected-material.md

@@ -15,9 +15,84 @@ keywords:
 
 # Protected material detection
 
-The [Protected material text API](../quickstart-protected-material.md) flags known text content (for example, song lyrics, articles, recipes, and selected web content) that might be output by large language models. This guide provides details about the kind of content that the protected material API detects.
+The [Protected material text API](../quickstart-protected-material.md) flags known text content (for example, song lyrics, articles, recipes, and selected web content) that might be output by large language models.
 
-## Protected material examples
+The [Protected material code API](../quickstart-protected-material-code.md) flags protected code content (from known GitHub repositories, including software libraries, source code, algorithms, and other proprietary programming content) that might be output by large language models.
+
+By detecting and preventing the display of protected material, organizations can ensure compliance with intellectual property laws, maintain content originality, and protect their reputations.
+
+This guide provides details about the kinds of content that the protected material API detects.
+
+## User scenarios
+
+#### [Protected text](#tab/text)
+
+### Content generation platforms for creative writing
+- Scenario: A content generation platform that uses generative AI for creative writing (for example, blog posts, stories, marketing copy) integrates the Protected Material for Text feature to prevent the generation of content that closely matches known copyrighted material.
+- User: Platform administrators and content creators.
+- Action: The platform uses Azure AI Content Safety to scan AI-generated content before it's provided to users. If the generated text matches protected material, the content is flagged and either blocked or revised.
+- Outcome: The platform avoids potential copyright infringements and ensures that all generated content is original and compliant with intellectual property laws.
+
+### Automated social media content creation
+- Scenario: A digital marketing agency uses generative AI to automate social media content creation. The agency integrates the Protected Material for Text feature to avoid publishing AI-generated content that includes copyrighted text, such as song lyrics or excerpts from books.
+- User: Digital marketers and social media managers.
+- Action: The agency employs Azure AI Content Safety to check all AI-generated social media content for matches against a database of protected material. Content that matches is flagged for revision or blocked from posting.
+- Outcome: The agency maintains compliance with copyright laws and avoids reputational risks associated with posting unauthorized content.
+
+### AI-assisted news writing
+- Scenario: A news outlet uses generative AI to assist journalists in drafting articles and reports. To ensure the content does not unintentionally replicate protected news articles or other copyrighted material, the outlet uses the Protected Material for Text feature.
+- User: Journalists, editors, and compliance officers.
+- Action: The news outlet integrates Azure AI Content Safety into its content creation workflow. AI-generated drafts are automatically scanned for protected content before submission for editorial review.
+- Outcome: The news outlet prevents accidental copyright violations and maintains the integrity and originality of its reporting.
+
+### E-learning platforms using AI for content generation
+- Scenario: An e-learning platform employs generative AI to generate educational content, such as summaries, quizzes, and explanatory text. The platform uses the Protected Material for Text feature to ensure the generated content does not include protected material from textbooks, articles, or academic papers.
+- User: Educational content creators and compliance officers.
+- Action: The platform integrates the feature to scan AI-generated educational materials. If any content matches known protected academic material, it is flagged for revision or automatically removed.
+- Outcome: The platform maintains educational content quality and complies with copyright laws, avoiding the use of protected material in AI-generated learning resources.
+
+### AI-powered recipe generators
+- Scenario: A food and recipe website uses generative AI to generate new recipes based on user preferences. To avoid generating content that matches protected recipes from famous cookbooks or websites, the website integrates the Protected Material for Text feature.
+- User: Content managers and platform administrators.
+- Action: The website uses Azure AI Content Safety to check AI-generated recipes against a database of known protected content. If a generated recipe matches a protected one, it is flagged and revised or blocked.
+- Outcome: The website ensures that all AI-generated recipes are original, reducing the risk of copyright infringement.
+
+#### [Protected code](#tab/code)
+
+### Software Development Platforms
+- Scenario: A software development platform that utilizes generative AI to help developers write code integrates the Protected Material for Code feature to prevent the generation of code that replicates material from existing GitHub repositories.
+- User: Platform administrators, developers.
+- Action: The platform uses Azure AI Content Safety to scan AI-generated code. If any code matches protected material, it's flagged for review, revised, or blocked.
+- Outcome: The platform ensures that all AI-generated code is original and complies with licensing agreements, reducing legal and compliance risks.
+
+### Automated Code Writing Tools
+- Scenario: A development team uses generative AI to automate parts of their code writing. The team integrates the Protected Material for Code feature to prevent the accidental use of code snippets that match content from existing GitHub repositories, including open-source code with restrictive licenses.
+- User: Software developers, DevOps teams.
+- Action: Azure AI Content Safety checks the generated code against known material from GitHub repositories. If a match is found, the code is flagged and revised before it is incorporated into the project.
+- Outcome: The team avoids potential copyright infringement and ensures the AI-generated code adheres to appropriate licenses.
+
+### AI-assisted Code Reviews
+- Scenario: A software company integrates AI-assisted code review tools into its development process. To avoid introducing protected code from GitHub or external libraries, the company leverages the Protected Material for Code feature.
+- User: Code reviewers, software developers, compliance officers.
+- Action: The company scans all AI-generated code for matches against protected material from GitHub repositories before final code review and deployment.
+- Outcome: The company prevents the inclusion of protected material in their projects, maintaining compliance with intellectual property laws and internal standards.
+
+### AI-generated Code for Educational Platforms
+- Scenario: An e-learning platform uses generative AI to generate example code for programming tutorials and courses. The platform integrates the Protected Material for Code feature to ensure that generated examples do not duplicate code from existing GitHub repositories or other educational sources.
+- User: Course creators, platform administrators.
+- Action: Azure AI Content Safety checks all AI-generated code examples for protected content. Matches are flagged, reviewed, and revised.
+- Outcome: The platform maintains the integrity and originality of its educational content while adhering to copyright laws.
+
+### AI-powered Coding Assistants
+- Scenario: A coding assistant tool powered by generative AI helps developers by generating code suggestions. To ensure that no suggestions infringe on code from GitHub repositories, the assistant tool uses the Protected Material for Code feature.
+- User: Developers, tool administrators.
+- Action: The tool scans all code suggestions for protected material from GitHub before presenting them to developers. If a suggestion matches protected code, it is flagged and not shown.
+- Outcome: The coding assistant ensures that all code suggestions are free from protected content, fostering originality and reducing legal risks.
+By integrating the Protected Material for Code feature, organizations can manage risks associated with AI-generated code, maintain compliance with intellectual property laws, and ensure the originality of their code outputs.
+
+---
+
+## Protected material text examples
 
 Refer to this table for details of the major categories of protected material text detection. All four categories are applied when you call the API.
 
@@ -29,7 +104,6 @@ Refer to this table for details of the major categories of protected material te
 | Lyrics      | Only focuses on issues of copyrighted content around Songs.     <br><br> Other harmful or sensitive text is out of scope for this task, unless it intersects Songs IP Copyright harm. | <ul><li>Links to web pages that contain information about songs such as:<ul><li>Lyrics of the songs</li><li>Chords or tabs of the associated music</li><li>Analysis or reviews of the song/music</li></ul></li><li>Links to authorized web pages that contain embedded audio/video players as long as:<ul><li>They have legitimate permissions</li><li>They have licensed music</li><li>They are authorized streaming platforms</li><li>They are official YouTube channels</li></ul></li><li>Short excerpts or snippets from lyrics of the songs as long as:<ul><li>They are relevant to the user's query</li><li>They are not a substantial part of the lyrics</li><li>They are not the entire lyrics</li><li>They are not more than 11 words long</li></ul></li><li>Short excerpts or snippets from chords/tabs of the songs as long as:<ul><li>They are relevant to the user's query</li><li>They are not a substantial part of the chords/tabs</li><li>They are not the entire chords/tabs</li></ul></li><li>Any content from songs that have no IP/Copyright protections:<ul><li>Songs/Lyrics/Chords/Tabs that are in the public domain</li><li>Songs/Lyrics/Chords/Tabs for which Copyright protection has elapsed, been surrendered, or never existed</li></ul></li><li>Rejection or refusal to provide copyrighted content:<ul><li>Changing topic to avoid sharing copyrighted content</li><li>Refusal to share copyrighted content</li><li>Providing nonresponsive information</li></ul></li></ul>         | <ul><li>Lyrics of a song<ul><li>Entire lyrics</li><li>Substantial part of the lyrics</li><li>Part of lyrics that contain more than 11 words</li></ul></li><li>Chords or Tabs of a song<ul><li>Entire chords/tabs</li><li>Substantial part of the chords/tabs</li></ul></li><li>Links to webpages that contain embedded audio/video players that:<ul><li>Do not have legitimate permissions</li><li>Do not have licensed music</li><li>Are not authorized streaming platforms</li><li>Are not official YouTube channels</li></ul></li><li>Methods to access copyrighted content:<ul><li>Steps to download songs from an unauthorized website</li><li>Ways to bypass paywalls or DRM protections to access copyrighted songs or videos</li></ul></li></ul>   |
 
 
-
 ## Next steps
 
 Follow the quickstart to get started using Azure AI Content Safety to detect protected material.