skills.rest
davidrrowley
davidrrowleyCOMMUNITY
Explore all skills by this author →
Website𝕏@davidrrowleyGitHub

agents-v2-py

Create container-based hosted agents in Azure AI Projects using ImageBasedHostedAgentDefinition.

Updated Apr 12, 2026
Search Tags:#azure#container#azure-ai-projects#hosted-agent#azure-container-registry#imagebasedhostedagent
One-click install
npx skills add https://github.com/davidrrowley/CortexYouV3 --skill agents-v2-py-davidrrowley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-v2-py
Source: https://github.com/davidrrowley/CortexYouV3/tree/main/.agents/skills/agents-v2-py
Command: npx skills add https://github.com/davidrrowley/CortexYouV3 --skill agents-v2-py-davidrrowley

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill reduces friction when building and deploying container-based hosted agents into Azure AI Projects by clarifying required SDK imports, authentication patterns, ACR prerequisites, and agent definition parameters so engineers can reliably create and manage custom agent versions.

Core Features & Use Cases

  • Hosted agent provisioning: Guidance to create ImageBasedHostedAgentDefinition instances and call create_version to register container-based agents.
  • Resource, tools, and environment configuration: Instructions for specifying cpu, memory, tools, and environment_variables for container runtime.
  • Lifecycle operations and troubleshooting: How to list and delete agent versions and address common errors such as ImagePullBackOff, missing permissions, and protocol configuration mismatches.
  • Use Case: Deploy a data-processing agent that runs custom code in a container image stored in Azure Container Registry, integrates a code interpreter tool, and communicates with an Azure AI Projects endpoint.

Quick Start

Create a hosted agent by providing your ACR image, granting AcrPull to the project's managed identity, and invoking AIProjectClient.create_version with DefaultAzureCredential.

Frequently Asked Questions about agents-v2-py

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a container-hosted agent in Azure AI Projects?▼

To deploy a container-hosted agent in Azure AI Projects, define an ImageBasedHostedAgentDefinition and register it by calling AIProjectClient.create_version with DefaultAzureCredential authentication.

What Azure Container Registry permissions are needed for custom container agents?▼

Container-hosted agents require AcrPull permissions granted to the Azure AI Projects managed identity to pull container images from your Azure Container Registry.

Which azure-ai-projects SDK version supports ImageBasedHostedAgentDefinition?▼

Container-based hosted agents require the azure-ai-projects SDK version 2.0.0b3 or higher to use the ImageBasedHostedAgentDefinition class.

Can I configure CPU and memory limits for Azure AI container agents?▼

Yes, you can specify CPU, memory, tools, and environment variables for container runtime by setting the respective parameters in the ImageBasedHostedAgentDefinition configuration.

How do I fix ImagePullBackOff errors with Azure AI hosted agents?▼

ImagePullBackOff errors typically occur when the Azure AI Projects managed identity lacks AcrPull permissions for the Azure Container Registry image, or the image path is incorrect.

What protocol version is required for Azure AI container agents?▼

Container-based hosted agents in Azure AI Projects require specifying AgentProtocol.RESPONSES v1 as the container_protocol_version in the agent definition.

Related Skills

Explore More Software Engineering Skills→
jongiojongio
6

container-app-acr-auth

Generate Bicep patterns for Azure Container Apps authentication with ACR managed identities.

Community
Intermediate
hashimichehashimiche
29

agent

Managees the lifecycle of your application's Docker-based agents.

Community
Intermediate
microsoftmicrosoft
2.9k

hosted-agents-v2-py

Create container-based hosted agents with the Azure AI Projects SDK.

Official
Advanced
unclehowellunclehowell

modal-serverless-gpu

Provision serverless GPU containers for machine-learning workloads via the Modal SDK.

Community
Advanced