AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

microsoft-foundry

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).

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read microsoft--microsoft-foundry at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 151

foundry-agent/deploy/references/voice-deploy.md

Voice Agent Deployment

Voice Agents are deployed through azd. First read create-voice, common Voice invariants, and the selected subtype reference linked from the creation workflow.

1. Resolve and Validate

Classify the selected service as Prompt Voice or Hosted Voice. For Hosted Voice, include both the Voice wrapper and its named hosted target in scope.

azd env get-values
azd ai project show --output json
azd ai agent show --output json

2. Provision When Required

Respect the project-selection gate: if no Foundry project endpoint is configured and the user has not asked to create one, stop and ask. Run azd provision --no-prompt when creating a project or provisioning model deployments or ACR infrastructure.

3. Deploy

Prompt Voice:

azd deploy <voice-service-name> --no-prompt

Hosted Voice: deploy the kind: hosted target before or together with the kind: voice wrapper:

azd deploy <target-service-name> --no-prompt
azd deploy <wrapper-service-name> --no-prompt

Alternatively, run azd deploy --no-prompt to deploy all services in dependency order.

4. Verify in Two Stages

  1. Run azd ai agent show --output json and verify status active or deployed. For Hosted Voice, report the active version of the target and wrapper separately.
  2. Do not run azd ai agent invoke; it does not support the voice protocol. Do not use generic azd ai agent eval generate as a Voice smoke test; transcript evaluation has separate limits in observe.
  3. Automated technical gate: run smoke-test-voice.sh or smoke-test-voice.ps1. Deployment is technically verified only when the service version(s) are active and this test succeeds.
  4. Manual experience acceptance: provide the Voice Agent Playground URL from azd ai agent show --output json and recommend a complete microphone/audio-to-audio test in the Foundry portal.

Follow Voice smoke testing; do not attribute portal-only experience properties to the automated smoke test.