Навыки agents-v2-py
📦

agents-v2-py

Безопасно 🔑 Переменные окружения

Создание размещаемых агентов Azure AI на основе контейнеров

Развертывание пользовательских ИИ-агентов в виде контейнеризированных служб в Azure AI Foundry без управления инфраструктурой. Используйте Azure AI Projects SDK для определения, развертывания и управления размещаемыми агентами с вашими собственными образами Docker и интегрированными инструментами.

Поддерживает: Claude Codex Code(CC)
🥉 72 Бронза
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «agents-v2-py». Создайте размещаемый агент с 2 ядрами ЦП, 4 Ги памяти и инструментом поиска файлов

Ожидаемый результат:

Размещаемый агент создан: data-processor-agent
Версия: v1.0.0
Состояние: Активно
Выделение ресурсов: 2 ЦП, 4 Ги памяти
Инструменты включены: code_interpreter, file_search

Использование «agents-v2-py». Перечислите все версии my-hosted-agent

Ожидаемый результат:

Версия: v1.0.0, Состояние: Активно, Создано: 2024-01-15
Версия: v1.1.0, Состояние: Активно, Создано: 2024-01-20
Версия: v2.0.0, Состояние: Активно, Создано: 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
Контент
30
Сообщество
100
Безопасность
100
Соответствие спецификации

Что вы можете построить

Развертывание агента для обработки пользовательских данных

Создайте размещаемый агент с пользовательским контейнером, который обрабатывает файлы с помощью интерпретатора кода и инструментов поиска файлов для автоматизированных конвейеров данных.

Создание ИИ-ассистента с поддержкой MCP

Разверните агент, который интегрирует внешние инструменты через протокол MCP, обеспечивая беспрепятственное подключение к пользовательским API и службам.

Система оркестрации нескольких агентов

Создавайте и управляйте несколькими специализированными размещаемыми агентами с различными выделениями ресурсов и конфигурациями инструментов для сложных рабочих процессов.

Попробуйте эти промпты

Базовое создание агента
Создайте размещаемый агент с использованием ImageBasedHostedAgentDefinition с моим образом контейнера по адресу myregistry.azurecr.io/my-agent:v1, выделив 1 ЦП и 2 Ги памяти с включенным интерпретатором кода.
Агент с конфигурацией среды
Создайте размещаемый агент, который передает AZURE_AI_PROJECT_ENDPOINT и MODEL_NAME в качестве переменных среды в контейнер, используя gpt-4o-mini в качестве модели.
Интеграция инструментов MCP
Разверните размещаемый агент с интерпретатором кода и инструментами MCP. Сервер MCP находится по адресу https://my-mcp-server.example.com с меткой 'custom-tools'.
Асинхронное управление агентом
Напишите асинхронную функцию Python, которая создает размещаемый агент, перечисляет все версии агента и удаляет устаревшие версии старше v2.0.

Лучшие практики

  • Используйте конкретные теги образов вместо 'latest' для производственных развертываний, чтобы обеспечить воспроизводимость
  • Начните с минимального выделения ресурсов (1 ЦП, 2 Ги) и масштабируйте на основе фактических шаблонов использования
  • Храните всю конфигурацию в переменных среды и используйте Azure Key Vault для конфиденциальных значений

Избегать

  • Жесткое кодирование секретов или строк подключения непосредственно в коде определения агента
  • Использование тега образа 'latest' в производственной среде, что может вызвать неожиданное поведение после обновления образа
  • Выделение максимальных ресурсов (4 ЦП, 8 Ги) без профилирования фактических требований к ресурсам

Часто задаваемые вопросы

Какова минимальная версия SDK, необходимая для размещаемых агентов?
Для поддержки ImageBasedHostedAgentDefinition требуется Azure AI Projects SDK версии 2.0.0b3 или более поздней.
Как предоставить моему агенту разрешение на извлечение из ACR?
Предоставьте управляемому удостоверению проекта Azure AI назначение роли 'AcrPull' в ресурсе Azure Container Registry.
Какие протоколы поддерживают размещаемые агенты?
Размещаемые агенты в настоящее время поддерживают AgentProtocol.RESPONSES с версией 'v1' для стандартных взаимодействий с агентом.
Могу ли я использовать несколько инструментов в одном размещаемом агенте?
Да, вы можете объединить code_interpreter, file_search и инструменты MCP в одном определении агента.
Как обрабатывать ошибки во время создания агента?
Оберните создание агента в блоки try/except и проверьте распространенные ошибки, такие как ImagePullBackOff, InvalidContainerImage и CapabilityHostNotFound.
Следует ли удалять старые версии агента?
Да, удалите неиспользуемые версии агента, чтобы освободить ресурсы. Используйте list_versions для определения устаревших версий перед удалением.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Ссылка

main

Структура файлов

📄 SKILL.md