Index of every page on this site: llms.txt
All skills
microsoft avatar

/azure-ai

@0d60658
by microsoftmicrosoft/skills3.2k stars
373
Run it yourself

Build and troubleshoot Azure AI Search, Speech, Document Intelligence, Content Understanding, Translator, Content Safety, and OpenAI apps. WHEN: AI Search, vector search, hybrid search, semantic search, indexer, speech-to-text, text-to-speech, fast or batch transcription, Speech SDK logs, session ID, result ID, OCR, document translation, glossary.

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-ai

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencescontent-safetyapi-preflight-and-diagnostics.md

≈938 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Standalone Azure AI Content Safety preflight and diagnostics

For direct standalone Azure AI Content Safety REST/SDK calls (POST {endpoint}/contentsafety/text:analyze, image:analyze, text:shieldPrompt, text/blocklists, API 2024-09-01). Route Azure API Management llm-content-safety policies to azure-aigateway, and Microsoft Foundry model/agent Guardrails to microsoft-foundry.

⚠️ Warning: Public preview Analyze Multimodal, Custom categories (rapid), Groundedness detection, Embedded SDK and Connected/Disconnected Content Safety containers retire April 30, 2027.

Workflow

  1. Confirm operation (text:analyze, image:analyze, text:shieldPrompt or blocklists), tier (F0: 5 RPS; S0: 1000 RP10S) and region. Never ask for keys or echo raw prompts, documents, blocklist terms or base64 images.

  2. Check node --version (Node.js 22+). Without Node (don't install it unasked), compare the request JSON with the table in step 3 without printing its text; for images check only file size and extension and report pixel dimensions as unknown. Otherwise run the local validator:

    node "<skill-directory>/scripts/validate-content-safety-request.mjs" --operation text-analyze --payload "<request.json>"
    & node "<skill-directory>\scripts\validate-content-safety-request.mjs" --operation text-analyze --payload "<request.json>"

    Operations: text-analyze, image-analyze (--payload and/or --image), shield-prompt. Bash and PowerShell launchers use exit codes 0 report/--help, 1 file/JSON error, 2 usage error, 3 Node 22+ missing.

  3. Check payload limits and semantics (2024-09-01):

Operation / field Public contract check
text:analyze text <= 10,000 characters (chunk longer text). Categories: Hate, SelfHarm, Sexual, Violence; omit categories for the default set. outputType: "FourSeverityLevels" (0,2,4,6, default) or "EightSeverityLevels" (0..7); with four levels, equality checks against odd values never match.
Blocklists blocklistNames allow 0-9 A-Z a-z - . _ ~ (<= 64 chars). haltOnBlocklistHit: true skips harm-category analysis when a blocklist matches.
image:analyze Image <= 4 MB, at least 50x50 px; the maximum is 2048x2048 in the 2024-09-01 API reference and 7200x7200 in the input-requirements table. JPEG/PNG/GIF/BMP/TIFF/WEBP. Send raw base64 (no data: prefix). outputType supports "FourSeverityLevels" only.
text:shieldPrompt userPrompt <= 10,000 chars; documents <= 5 strings and <= 10,000 combined chars. Returns attackDetected booleans for prompt/indirect injection (not general harm moderation).
Auth & region Entra ID requires a custom subdomain and Cognitive Services User. Features vary by region; on 404/400 check region support and record the error code and apim-request-id.

Sources

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning11d4 checks · Risk SAFE
  • Gen Agent Trust Hub11d

    This skill provides tools and guidance for developing and troubleshooting Azure AI services. It includes a local diagnostic script for analyzing Speech SDK logs with robust safety controls, along with comprehensive references for official Azure SDKs and secure authentication practices.

  • Socket11d

    No alerts

  • Snyk11d

    Risk: LOW · No issues

  • Runlayer9mo

    15/15 files flagged

Signed by skilld at 0d60658. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 days ago
metadata
{
  "author": "Microsoft",
  "version": "1.2.6"
}

README badge

README badge for microsoft/skills/azure-ai