المهارات agents-v2-py
📦

agents-v2-py

آمن 🔑 متغيرات البيئة

Criar Agentes Hospedados em Container do Azure AI

Implante agentes de IA personalizados como serviços conteinerizados no Azure AI Foundry sem gerenciar infraestrutura. Use o Azure AI Projects SDK para definir, implantar e gerenciar agentes hospedados com suas próprias imagens Docker e ferramentas integradas.

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "agents-v2-py". Create a hosted agent with 2 CPU cores, 4Gi memory, and file search tool

النتيجة المتوقعة:

Agente hospedado criado: data-processor-agent
Versão: v1.0.0
Estado: Ativo
Alocação de recursos: 2 CPU, 4Gi memória
Ferramentas habilitadas: code_interpreter, file_search

استخدام "agents-v2-py". List all versions of my-hosted-agent

النتيجة المتوقعة:

Versão: v1.0.0, Estado: Ativo, Criado: 2024-01-15
Versão: v1.1.0, Estado: Ativo, Criado: 2024-01-20
Versão: v2.0.0, Estado: Ativo, Criado: 2024-01-25

التدقيق الأمني

آمن
v1 • 2/24/2026

This skill is a Python SDK documentation guide for Azure AI Foundry hosted agents. All 79 static analysis findings were evaluated and dismissed as false positives. The markdown backticks were incorrectly flagged as shell execution, environment variable usage follows security best practices, and documentation URLs are not active network calls. No malicious patterns detected.

1
الملفات التي تم فحصها
327
الأسطر التي تم تحليلها
2
النتائج
1
إجمالي عمليات التدقيق
مشكلات منخفضة المخاطر (1)
Environment Variable Access for Configuration
The skill uses os.environ to read AZURE_AI_PROJECT_ENDPOINT. This is legitimate configuration access following security best practices (avoiding hardcoded secrets). Low risk as it only reads expected environment configuration.
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

Implantar Agente Personalizado de Processamento de Dados

Crie um agente hospedado com um contêiner personalizado que processa arquivos usando interpretador de código e ferramentas de busca de arquivos para pipelines de dados automatizados.

Criar Assistente de IA com Suporte a MCP

Implemente um agente que integra ferramentas externas via protocolo MCP, permitindo conexão seamless com APIs e serviços personalizados.

Sistema de Orquestração Multi-Agente

Crie e gerencie múltiplos agentes hospedados especializados com diferentes alocações de recursos e configurações de ferramentas para fluxos de trabalho complexos.

جرّب هذه الموجهات

Criação Básica de Agente
Create a hosted agent using ImageBasedHostedAgentDefinition with my container image at myregistry.azurecr.io/my-agent:v1, allocating 1 CPU and 2Gi memory with code interpreter enabled.
Agente com Configuração de Ambiente
Create a hosted agent that passes AZURE_AI_PROJECT_ENDPOINT and MODEL_NAME as environment variables to the container, using gpt-4o-mini as the model.
Integração de Ferramentas MCP
Deploy a hosted agent with both code interpreter and MCP tools. The MCP server is at https://my-mcp-server.example.com with label 'custom-tools'.
Gerenciamento Assíncrono de Agentes
Write an async Python function that creates a hosted agent, lists all agent versions, and deletes outdated versions older than v2.0.

أفضل الممارسات

  • Use tags de imagem específicas em vez de 'latest' para implantações em produção para garantir reprodutibilidade
  • Comece com alocação mínima de recursos (1 CPU, 2Gi) e escale com base nos padrões de uso reais
  • Armazene toda a configuração em variáveis de ambiente e use o Azure Key Vault para valores sensíveis

تجنب

  • Codificar segredos ou strings de conexão diretamente no código de definição do agente
  • Usar a tag de imagem 'latest' em produção que pode causar comportamento inesperado após atualizações de imagem
  • Alocar recursos máximos (4 CPU, 8Gi) sem analisar os requisitos reais de recursos

الأسئلة المتكررة

Qual é a versão mínima do SDK necessária para agentes hospedados?
Azure AI Projects SDK versão 2.0.0b3 ou posterior é necessário para suporte a ImageBasedHostedAgentDefinition.
Como concedo permissão ao meu agente para fazer pull do ACR?
Conceda a identidade gerenciada do Projeto Azure AI a atribuição de função 'AcrPull' no seu recurso Azure Container Registry.
Quais protocolos os agentes hospedados suportam?
Agentes hospedados atualmente suportam AgentProtocol.RESPONSES com versão 'v1' para interações padrão de agentes.
Posso usar múltiplas ferramentas em um único agente hospedado?
Sim, você pode combinar code_interpreter, file_search e MCP tools em uma única definição de agente.
Como lidar com erros durante a criação do agente?
Envolva a criação do agente em blocos try/except e verifique erros comuns como ImagePullBackOff, InvalidContainerImage e CapabilityHostNotFound.
Devo excluir versões antigas do agente?
Sim, exclua versões não utilizadas do agente para liberar recursos. Use list_versions para identificar versões desatualizadas antes da exclusão.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md