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-agenthosted-voice-yaml.md

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

Hosted Voice YAML

Author a voice-based agent that uses a hosted text agent as its conversation engine. Apply common invariants and the Voice Live Bridge 1.0 contract.

Ownership

Service Owns
Hosted target (kind: hosted) Model calls, instructions, tools, bounded history, Voice Live Bridge handler
Managed Voice wrapper (kind: voice) Audio, VAD, transcription, synthesis, greeting, managed Voice endpoint

Minimal Shape

services:
  travel-target:
    project: src/travel-target
    host: azure.ai.agent
    uses: [ai-project]
    kind: hosted
    name: travel-target
    language: python
    codeConfiguration:
      entryPoint: main.py
      runtime: python_3_13
    env:
      AZURE_AI_MODEL_DEPLOYMENT_NAME: ${AZURE_AI_MODEL_DEPLOYMENT_NAME}
    protocols:
      - protocol: voice_conversation_engine
        version: 1.0.0

  travel-voice:
    host: azure.ai.agent
    uses: [ai-project, travel-target]
    kind: voice
    name: travel-voice
    conversationEngine:
      type: hosted_agent
      name: travel-target
    greeting:
      type: template
      text: Hello! How can I help?
    outputModalities: [audio]

conversationEngine.version is optional; the only supported value is deployed, which is also the default when omitted.

The wrapper must omit target-owned fields such as model, modelType, instructions, tools, protocols, codeConfiguration, environment settings, and session policies. The wrapper's uses entry establishes target-before-wrapper deployment order.

Legacy Target Compatibility

Use the legacy shape only when the user explicitly selects invocations_ws or the manifest already declares invocations_ws/1.0.0 and both metadata values:

protocols:
  - protocol: invocations_ws
    version: 1.0.0
metadata:
  voiceLiveCompatible: "true"
  bridgeProtocolVersion: "1.0"

Preserve this shape during ordinary edits and redeploys; do not auto-migrate it. The dedicated and legacy protocol endpoints are not interchangeable. Both declarations may coexist, but do not use that as the normal new manifest.

When requested wrapper settings require YAML edits, load Voice Agent YAML settings. Preserve unrelated existing wrapper fields, keep target and wrapper names distinct, and deploy the target before or together with the wrapper.

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