Suporte upstream incluído

Arquivos de suporte são incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

Segurança de helper restaurada

scripts/run_batch_evaluation.py envia o arquivo JSONL selecionado inteiro para o projeto Azure AI configurado, cria uma avaliação e execução remota, e pode gerar custos de modelo ou nuvem. Antes de invocar, revise a classificação dos dados e confirme o arquivo exato, endpoint, implantação, avaliadores e custo esperado com o usuário. Não execute durante trabalhos apenas de documentação.

SDK Python para Projetos Azure AI (SDK Foundry)

Construa aplicações de IA no Microsoft Foundry usando o SDK azure-ai-projects.

Instalação

pip install azure-ai-projects azure-identity

Variáveis de Ambiente

AZURE_AI_PROJECT_ENDPOINT="https://<resource>.services.ai.azure.com/api/projects/<project>"
AZURE_AI_MODEL_DEPLOYMENT_NAME="gpt-4o-mini"

Autenticação

import os
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

credential = DefaultAzureCredential()
client = AIProjectClient(
    endpoint=os.environ["AZURE_AI_PROJECT_ENDPOINT"],
    credential=credential,
)

Visão Geral das Operações do Cliente

Duas Abordagens de Cliente

1. AIProjectClient (Nativo do Foundry)

from azure.ai.projects import AIProjectClient

client = AIProjectClient(
    endpoint=os.environ["AZURE_AI_PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential(),
)

# Use Foundry-native operations
agent = client.agents.create_agent(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    name="my-agent",
    instructions="You are helpful.",
)

2. Cliente Compatível com OpenAI

# Get OpenAI-compatible client from project
openai_client = client.get_openai_client()

# Use standard OpenAI API
response = openai_client.chat.completions.create(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    messages=[{"role": "user", "content": "Hello!"}],
)

Operações de Agente

Criar Agente (Básico)

agent = client.agents.create_agent(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    name="my-agent",
    instructions="You are a helpful assistant.",
)

Criar Agente com Ferramentas

from azure.ai.agents import CodeInterpreterTool, FileSearchTool

agent = client.agents.create_agent(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    name="tool-agent",
    instructions="You can execute code and search files.",
    tools=[CodeInterpreterTool(), FileSearchTool()],
)

Agentes Versionados com PromptAgentDefinition

from azure.ai.projects.models import PromptAgentDefinition

# Create a versioned agent
agent_version = client.agents.create_version(
    agent_name="customer-support-agent",
    definition=PromptAgentDefinition(
        model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
        instructions="You are a customer support specialist.",
        tools=[],  # Add tools as needed
    ),
    version_label="v1.0",
)

Veja references/agents.md para padrões detalhados de agentes.

Visão Geral das Ferramentas

Veja references/tools.md para todos os padrões de ferramentas.

Fluxo de Thread e Mensagem

# 1. Criar thread
thread = client.agents.threads.create()

# 2. Adicionar mensagem

…