功能描述

Azure AI Transcription SDK for Python. Use for real-time and batch speech-to-text transcription with timestamps and diarization. Triggers: "transcription", "speech to text", "Azure AI Transcription", "TranscriptionClient".

使用说明 (SKILL.md)

Azure AI Transcription SDK for Python

Name: Azure Ai Transcription Py
Author: thegovind

Client library for Azure AI Transcription (speech-to-text) with real-time and batch transcription.

Installation

pip install azure-ai-transcription

Environment Variables

TRANSCRIPTION_ENDPOINT=https://\x3Cresource>.cognitiveservices.azure.com
TRANSCRIPTION_KEY=\x3Cyour-key>

Authentication

Use subscription key authentication (DefaultAzureCredential is not supported for this client):

import os
from azure.ai.transcription import TranscriptionClient

client = TranscriptionClient(
    endpoint=os.environ["TRANSCRIPTION_ENDPOINT"],
    credential=os.environ["TRANSCRIPTION_KEY"]
)

Transcription (Batch)

job = client.begin_transcription(
    name="meeting-transcription",
    locale="en-US",
    content_urls=["https://\x3Cstorage>/audio.wav"],
    diarization_enabled=True
)
result = job.result()
print(result.status)

Transcription (Real-time)

stream = client.begin_stream_transcription(locale="en-US")
stream.send_audio_file("audio.wav")
for event in stream:
    print(event.text)

Best Practices

Enable diarization when multiple speakers are present
Use batch transcription for long files stored in blob storage
Capture timestamps for subtitle generation
Specify language to improve recognition accuracy
Handle streaming backpressure for real-time transcription
Close transcription sessions when complete

安全使用建议

This SKILL.md describes a legitimate Azure transcription client, but the package and credentials handling need verification before installing. Before you install or run it: 1) Confirm the pip package name (azure-ai-transcription) on PyPI and that it is the official Azure SDK or a trusted publisher; prefer pinned versions. 2) Don't paste your TRANSCRIPTION_KEY into public places; use least-privilege keys and consider managed identity or safer auth if available. 3) Be aware pip install fetches and runs code from the network — audit the package or review its source first. 4) Ask the skill author or registry maintainer to declare required environment variables (TRANSCRIPTION_ENDPOINT, TRANSCRIPTION_KEY) in the metadata so the manifest matches runtime requirements. If you cannot verify the package origin or the skill metadata remains inconsistent, treat it as risky and avoid installing.

功能分析

Type: OpenClaw Skill Name: azure-ai-transcription-py Version: 0.1.0 The skill bundle appears benign. It provides instructions and code examples for using the Azure AI Transcription SDK for Python. The `SKILL.md` file details standard `pip install` commands, environment variable setup (`TRANSCRIPTION_ENDPOINT`, `TRANSCRIPTION_KEY`), and Python code snippets for authentication and transcription. There is no evidence of data exfiltration beyond expected credential usage for the Azure service, malicious execution, persistence mechanisms, prompt injection attempts against the agent, or obfuscation. All content aligns with the stated purpose of an Azure AI Transcription skill.

能力评估

ℹ Purpose & Capability

The name, description, and SKILL.md consistently describe an Azure speech-to-text client (batch and streaming). The examples reference azure-ai-transcription and Azure endpoints, which is coherent with the stated purpose. However, the registry metadata declares no required environment variables or credentials while the runtime docs require TRANSCRIPTION_ENDPOINT and TRANSCRIPTION_KEY — this mismatch is unexpected.

✓ Instruction Scope

SKILL.md instructions are narrowly scoped to installing the client, configuring an endpoint/key, and calling the TranscriptionClient for batch or real-time transcription. The only file access shown is audio files (local or blob URLs) needed for transcription. There are no instructions to read unrelated system files, credentials, or send data to endpoints outside Azure/storage examples.

ℹ Install Mechanism

The skill is instruction-only (no install spec), but the SKILL.md explicitly tells users to run `pip install azure-ai-transcription`. That means installing a PyPI package at runtime (network fetch, code execution). This is expected for a Python SDK but is a non-trivial step not reflected in metadata — consider verifying the package origin and integrity before installing.

⚠ Credentials

The runtime docs require TRANSCRIPTION_ENDPOINT and TRANSCRIPTION_KEY (Azure endpoint and subscription key). Those credentials are appropriate for the described service, but the skill metadata declares no required env vars or primary credential. The mismatch is a red flag because credentials are necessary for operation yet not declared in the manifest; verify where/how the key will be provided and that it has least-privilege permissions.

✓ Persistence & Privilege

The skill does not request persistent presence (always: false) and is user-invocable. There is no indication it modifies other skills or system-wide settings. Autonomous invocation is allowed by default but not combined with other high-risk signals here.

版本历史

v0.1.0

Initial release of azure-ai-transcription-py — Azure AI speech-to-text SDK for Python. - Provides client library for real-time and batch transcription with timestamps and diarization. - Supports subscription key authentication. - Offers usage examples for both batch and streaming transcription. - Lists essential environment variables for authentication and endpoint configuration. - Includes best practices for optimal transcription results.

元数据

Slug azure-ai-transcription-py

版本 0.1.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Azure Ai Transcription Py 是什么？

Azure AI Transcription SDK for Python. Use for real-time and batch speech-to-text transcription with timestamps and diarization. Triggers: "transcription", "speech to text", "Azure AI Transcription", "TranscriptionClient". 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2150 次。

如何安装 Azure Ai Transcription Py？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install azure-ai-transcription-py」即可一键安装，无需额外配置。

Azure Ai Transcription Py 是免费的吗？

是的，Azure Ai Transcription Py 完全免费（开源免费），可自由下载、安装和使用。

Azure Ai Transcription Py 支持哪些平台？

Azure Ai Transcription Py 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Azure Ai Transcription Py？

由 thegovind（@thegovind）开发并维护，当前版本 v0.1.0。

Azure Ai Transcription Py