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

/microsoft-foundry

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

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent, managed harness agent, Copilot harness, voice agent, create/update/invoke/evaluate agent, add tool to agent, agent insights, batch/continuous eval, continuous monitoring, agent CI/CD, optimize/improve prompt, optimize agent instructions, Agent Optimizer, dataset curation from traces, deploy model, model fine-tuning (SFT/DPO/RFT), Foundry project, RBAC, role assignment, permissions, quota, capacity, region, deployment failure, AI Services, create Foundry resource, knowledge index, customize deployment, onboard, availability, training-data, grader, distillation, large file upload. DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy), general Azure prep (use azure-prepare).

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

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

foundry-agentcreatereferencesvoice-agentgpt-live-voice-yaml.md

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

GPT-Live Voice YAML

Author GPT-Live Voice after selecting it with Voice Agent subtypes and applying common invariants. It is not a Prompt Voice setting and does not use a Hosted Voice Bridge.

Canonical Shape

services:
  live-assistant:
    host: azure.ai.agent
    uses: [ai-project]
    kind: voice
    name: live-assistant
    subProtocol: live
    modelType: self_deployed
    model:
      id: gpt-live-1

model.id must match the exact compatible deployment name.

Self-Deployed Model Golden Path

GPT-Live Voice has no managed-model branch. Apply this lifecycle to the GPT-Live model and to delegation.responses.model when Responses delegation is configured:

  1. Inspect the selected Foundry account for the exact compatible deployment name. Reuse an existing deployment without adding a duplicate entry.
  2. If it is missing, read Foundry Model Reference and resolve the exact version, format, supported SKU/capacity, lifecycle, and quota. State the billable/quota-consuming change, and obtain confirmation unless creation was explicit.
  3. Preserve existing project infrastructure and deployment entries, append the resolved deployment under services.<ai-project-service>.deployments[], and set model.id or delegation.responses.model to the exact deployments[].name.
  4. Run azd provision --preview --no-prompt, confirm only the intended model infrastructure changes, then run azd provision --no-prompt.
  5. Deploy the Voice service only after provisioning succeeds.

Do not use az cognitiveservices account deployment create in the normal skill flow; keep azure.yaml as the azd source of truth.

Optional Settings and Known Values

Preserve unrelated existing fields and omit unused optional fields rather than writing null.

instructions: Respond naturally and concisely.
store: false
audio:
  format: { type: audio/pcm, rate: 24000 }
  output:
    voice: marin
greeting: { type: template, text: "Hello {{name}}" }
structuredInputs:
  name:
    description: Caller name
    schema: { type: string }
    required: false
    defaultValue: Ada
policies:
  - type: rai_policy
    raiPolicyName: <rai-policy-resource-id>
Setting Supported shape
audio.format audio/pcm at 16000 or 24000; audio/pcmu or audio/pcma at 8000
audio.output.voice Nonblank built-in voice string, or { id: <custom-voice-id> } only
instructions / store String / boolean
greeting Exactly type: template plus nonblank text
structuredInputs.<name> Optional description string, schema object, required boolean, and defaultValue
policies At most one named rai_policy with full-resource-ID raiPolicyName; no invocationsModeration

Delegation

delegation: { type: client }
delegation:
  type: responses
  responses:
    model: <responses-deployment-name>
    instructions: Return concise backend guidance.
delegation:
  type: foundry_managed_agent
  agentName: <existing-agent-name>
  agentVersion: "<positive-version>"
  • client supports only type.
  • responses requires responses.model and must omit agentName/agentVersion.
  • foundry_managed_agent requires agentName, may include a positive numeric-string agentVersion, and must omit responses.
responses option Supported shape
instructions String
maxOutputTokens / parallelToolCalls Positive integer / boolean
serviceTier auto, default, fast_tier_temp_pilot, flex, priority, or ultrafast
reasoning effort: `none
text.verbosity low, medium, or high
toolChoice `auto
tools { type: web_search }, or function with name, optional description, parameters object, and optional boolean strict

Constraints and Forbidden Fields

Forbidden or discriminator-incompatible fields are rejected even when empty or null. Do not author audio.input transcription/VAD/noise reduction/echo cancellation, audio.output.format/speed, conversationEngine, targetAgent, root voice, input/output schemas, output modalities, root tools/tool choice/output-token settings, avatar, handoff, include, or telephony.

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.

3 warningstoday4 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides a comprehensive suite of tools for managing AI agents and models on Microsoft Foundry. It includes security considerations such as the dynamic execution of user-provided Python scripts for model evaluation and the processing of production traces for dataset creation. These features are aligned with the skill's primary purpose and include appropriate user warnings and human-in-the-loop review steps to mitigate risk. See the detailed analysis for additional context.

  • Sockettoday

    2 alerts: gptSecurity, gptAnomaly

  • Snyktoday

    Risk: MEDIUM · 2 issues

  • Runlayer9mo

    36/36 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 5 days ago
metadata
{
  "author": "Microsoft",
  "version": "1.2.36"
}

README badge

README badge for microsoft/skills/microsoft-foundry