Azure Ai

Azure AI Content Safety — Java SDK Quick Reference

Condensed from azure-ai-contentsafety-java. Full patterns (blocklist management, image moderation, 8-severity)

in the azure-ai-contentsafety-java plugin skill if installed.

Install

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-ai-contentsafety</artifactId>
  <version>1.1.0-beta.1</version>
</dependency>

Quick Start

import com.azure.ai.contentsafety.ContentSafetyClient;
import com.azure.ai.contentsafety.ContentSafetyClientBuilder;
import com.azure.ai.contentsafety.BlocklistClient;
import com.azure.ai.contentsafety.BlocklistClientBuilder;
ContentSafetyClient client = new ContentSafetyClientBuilder()
    .endpoint(endpoint).credential(credential).buildClient();

Non-Obvious Patterns

• Two separate builders: ContentSafetyClientBuilder and BlocklistClientBuilder
• Image from file: new ContentSafetyImageData().setContent(BinaryData.fromBytes(bytes))
• Image from URL: new ContentSafetyImageData().setBlobUrl(url)
• Blocklist create uses raw BinaryData + RequestOptions (not typed model)

Best Practices

1. Blocklist changes take ~5 minutes to take effect 2. Only request needed categories to reduce latency 3. Typically block severity >= 4 for strict moderation 4. Process multiple items in parallel for throughput 5. Cache blocklist results where appropriate

--- name: azure-ai description: "Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech." license: MIT metadata: author: Microsoft version: "1.1.1" ---

Azure AI Services

Services

MCP Server (Preferred)

When Azure MCP is enabled:

AI Search

• azure__search with command search_index_list - List search indexes
• azure__search with command search_index_get - Get index details
• azure__search with command search_query - Query search index

Speech

• azure__speech with command speech_transcribe - Speech to text
• azure__speech with command speech_synthesize - Text to speech

If Azure MCP is not enabled: Run /azure:setup or enable via /mcp.

AI Search Capabilities

Speech Capabilities

SDK Quick References

For programmatic access to these services, see the condensed SDK guides:

• AI Search: Python | TypeScript | .NET
• OpenAI: .NET
• Vision: Python | Java
• Transcription: Python
• Translation: Python | TypeScript
• Document Intelligence