Utilização dos endpoints Microsoft Foundry

No Foundry, podes definir os modelos e agentes que queres usar em aplicações de IA personalizadas. Como os recursos da Foundry são baseados na cloud, pode consumi-los como Interfaces de Programação de Aplicações (APIs) através de ligações à internet através de interfaces programáticas.

Compreender os endpoints

Tal como a maioria dos serviços cloud, os recursos Microsoft Foundry são acedidos através de um endpoint API, que representa um ponto de entrada de serviço. O endpoint tem um endereço HTTP único, como um site, mas é para código de aplicação cliente e não para utilizadores humanos com um navegador web. Quando visualizas o endpoint do teu modelo, ele parece algo como:

https://<foundry-project>-resource.cognitiveservices.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-05-01-preview

As interfaces fornecidas no ponto final são conhecidas como Interfaces de Transferência de Estado Representacional, ou interfaces REST para abreviar.

O endpoint está protegido para manter os seus recursos da Foundry seguros. As aplicações só podem aceder se apresentarem a chave API correta ou um token que confirme que as credenciais do seu ID Microsoft Entra são válidas. O endpoint e a chave do modelo podem ser encontrados na página de detalhes do Foundry Playground.

Dois tipos comuns de endpoints no Foundry são:

• Endpoints ao nível do projeto: para gerir o seu projeto Foundry e respetivos recursos
• Endpoints de modelos: para enviar sugestões a modelos implementados

Utilização dos pontos finais

As aplicações comunicam com o endpoint enviando pedidos REST. Os pedidos REST consistem em cabeçalhos contendo metadados, como autenticação e informação de formato de dados, e um corpo composto por dados em formato JSON. Por exemplo, um pedido pode incluir um prompt introduzido por um utilizador numa aplicação de chat, como "O que é uma aplicação de IA?".

curl -X POST https://YOUR-FOUNDRY-RESOURCE-NAME.services.ai.azure.com/api/projects/YOUR-PROJECT-NAME/openai/responses?api-version=2025-11-15-preview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
-d '{
        "model": "gpt-4.1-mini",
        "input": "What is an AI application?"
}'

Os resultados do pedido são retornados como uma resposta, junto com os cabeçalhos e o corpo. Por exemplo, a resposta pode incluir a resposta gerada por um modelo a partir do prompt. A resposta chega em formato JSON. Uma secção desse JSON pode assemelhar-se à seguinte:

{
    "metadata": {},
    "temperature": 1,
    "model": "gpt-4.1-mini",
    "object": "response",
    "status": "completed",
    "output": [
        {
            "type": "message",
            "status": "completed",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "An AI application is a software program or system that utilizes artificial intelligence technologies to perform tasks that typically require human intelligence. These tasks can include recognizing speech, understanding natural language, making decisions, learning from data, recognizing images, and solving complex problems. AI applications are used in various fields such as healthcare, finance, customer service, autonomous vehicles, and more to enhance efficiency, accuracy, and user experience."
                }
            ]
        }
    ]
}

Embora os programadores possam escrever código que funcione diretamente com as interfaces REST, a maioria prefere trabalhar com kits de desenvolvimento de software (SDKs) que abstraem as interfaces REST com bibliotecas de código para a sua linguagem de programação preferida, como Python, JavaScript ou C#. Estes ajudantes específicos para a língua criam chamadas REST para si.

O endpoint para os seus recursos Foundry é o ponto central de serviço para aplicações clientes, permitindo-lhe construir soluções personalizadas apoiadas na segurança, escalabilidade e fiabilidade da Azure Cloud Platform.

De seguida, vamos tentar criar um recurso Foundry e usar o seu endpoint.