【研发类-AI和ML开发Skills】agents-v2-py 技能
使用Azure AI Projects SDKImageBasedHostedAgentDefinition构建基于容器的Foundry Agents。在Azure AI Foundry中使用自定义容器镜像创建托管智能体时使用。技能概述agents-v2-py 技能专注于使用Azure AI Projects SDK中的ImageBasedHostedAgentDefinition构建基于容器的托管智能体。这些智能体运行在Azure AI Foundry中使用自定义容器镜像提供更高的灵活性和控制力。下载地址agentic-awesome-skills/skills/agents-v2-py at main · sickn33/agentic-awesome-skills · GitHub主要功能容器化智能体使用自定义容器镜像构建托管智能体资源分配配置CPU和内存资源协议版本管理指定智能体支持的协议版本工具集成为智能体配置可用工具环境变量配置设置容器环境变量版本管理创建、列出和删除智能体版本前置要求容器镜像构建并推送到Azure Container Registry (ACR)ACR拉取权限为项目的托管身份授予ACR上的AcrPull角色能力主机账户级别的能力主机启用enablePublicHostingEnvironmenttrueSDK版本确保azure-ai-projects2.0.0b3安装pip install azure-ai-projects2.0.0b3 azure-identity最低SDK版本需要2.0.0b3或更高版本以支持托管智能体。环境变量AZURE_AI_PROJECT_ENDPOINThttps://resource.services.ai.azure.com/api/projects/project核心工作流程1. 创建托管智能体pythonfrom azure.identity import DefaultAzureCredentialfrom azure.ai.projects import AIProjectClientfrom azure.ai.projects.models import (ImageBasedHostedAgentDefinition,ProtocolVersionRecord,AgentProtocol,)client AIProjectClient(endpointos.environ[AZURE_AI_PROJECT_ENDPOINT],credentialDefaultAzureCredential())agent client.agents.create_version(agent_namemy-hosted-agent,definitionImageBasedHostedAgentDefinition(container_protocol_versions[ProtocolVersionRecord(protocolAgentProtocol.RESPONSES, versionv1)],cpu1,memory2Gi,imagemyregistry.azurecr.io/my-agent:latest,tools[{type: code_interpreter}],environment_variables{AZURE_AI_PROJECT_ENDPOINT: os.environ[AZURE_AI_PROJECT_ENDPOINT],MODEL_NAME: gpt-4o-mini}))ImageBasedHostedAgentDefinition参数参数类型必需描述container_protocol_versionslist[ProtocolVersionRecord]是智能体支持的协议版本imagestr是完整的容器镜像路径registry/image:tagcpustr否CPU分配如1、2memorystr否内存分配如2Gi、4Gitoolslist[dict]否智能体可用的工具environment_variablesdict[str, str]否容器的环境变量最佳实践始终使用DefaultAzureCredential进行身份验证为容器配置适当的CPU和内存资源使用环境变量传递配置信息定期清理不需要的智能体版本确保容器镜像已正确推送到ACR技能元数据添加日期2026-02-27风险等级unknown来源community
