All skills
microsoft avatar

/microsoft-foundry

@04110d9
by microsoftmicrosoft/skills3.1k stars
351

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 create, create agent, update agent, add tool to agent, invoke agent, agent.yaml, agent insights, pull agent insights, evaluate agent, batch eval, continuous eval, continuous monitoring, agent CI/CD, optimize prompt, improve prompt, prompt optimizer, optimize agent instructions, Agent Optimizer scaffold, 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

This session only. Nothing lands on disk.

projectconnections.md

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

Foundry Project Connections

Connections authenticate and link external resources to a Foundry project. Many agent tools (Azure AI Search, Bing Grounding, MCP) require a project connection before use.

Managing Connections via MCP

Use the Foundry MCP server for all connection operations. The MCP tools handle authentication, validation, and project scoping automatically.

Operation MCP Tool Description
List all connections project_connection_list Lists project connections and can filter by category or target
Get connection details project_connection_get Retrieves a specific connection by connectionName
Create a connection project_connection_create Creates or replaces a project connection to an external resource
Update a connection project_connection_update Updates auth, category, target, or expiry on an existing connection
Delete a connection project_connection_delete Removes a connection from the project by name
List supported categories/auth types project_connection_list_metadata Lists valid connection categories and auth types before create/update

💡 Tip: Use project_connection_get or project_connection_list to resolve the connection name and full connection resource ID before configuring agent tools that require project_connection_id.

Create Connection via Portal

  1. Open Microsoft Foundry portal
  2. Navigate to Operate → Admin → select your project
  3. Select Add connection → choose service type
  4. Browse for resource, select auth method, click Add connection

Connection ID Format

For REST and TypeScript samples, the full connection ID format is:

/subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project}/connections/{connectionName}

Python and C# SDKs resolve this automatically from the connection name.

Common Connection Types

Type Resource Used By
azure_ai_search Azure AI Search AI Search tool
bing Grounding with Bing Search Bing grounding tool
bing_custom_search Grounding with Bing Custom Search Bing Custom Search tool
api_key Any API-key resource MCP servers, custom tools
azure_openai Azure OpenAI Model access
AzureStorageAccount Azure Blob Storage Dataset upload via evaluation_dataset_create

RBAC for Connection Management

Role Scope Permission
Foundry Project Manager Project Create/manage project connections
Contributor or Owner Subscription/RG Create Bing/Search resources, get keys

Troubleshooting

Error Cause Fix
Connection not found Name mismatch or wrong project Use project_connection_list to find the correct connectionName
Unauthorized creating connection Missing Foundry Project Manager role Assign role on the Foundry project
Invalid connection ID format Using name instead of full resource ID Use project_connection_get to resolve the full ID

Source: SKILL.md on GitHub

2 warnings3d4 checks · Risk SAFE
  • Gen Agent Trust Hub3d

    This skill provides a comprehensive environment for managing the end-to-end lifecycle of AI agents, models, and infrastructure on Microsoft Foundry. It includes sub-skills for deployment, evaluation, fine-tuning, and troubleshooting. The skill utilizes dynamic code execution and shell command wrappers, which are used within the context of local development and cloud orchestration. All external resources and dependencies originate from trusted organizations and well-known services.

  • Socket3d

    2 alerts: gptSecurity, gptAnomaly

  • Snyk3d

    Risk: LOW · No issues

  • Runlayer7mo

    36/36 files flagged

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

Last checked against GitHub yesterday.

Activeupdated last week
metadata
{
  "author": "Microsoft",
  "version": "1.2.26"
}

README badge

README badge for microsoft/skills/microsoft-foundry