Desenvolver uma aplicação cliente para um agente de IA

  • 5 minutos

Sugestão

Consulte a guia Texto e imagens para obter mais detalhes!

Um agente no Microsoft Foundry encapsula o modelo, as instruções e as ferramentas necessárias para realizar tarefas. Para tornar o agente disponível aos utilizadores, pode construir uma aplicação cliente que envia prompts ao agente e processa as suas respostas.

Liga-te a um agente

Um agente em execução no Foundry fornece um endpoint que suporta o protocolo OpenAI Responses. As aplicações podem ligar-se a este endpoint usando o SDK OpenAI, e utilizadores ou identidades de aplicações com permissões apropriadas podem autenticar-se usando o Microsoft Entra ID.

Por exemplo, pode desenvolver uma aplicação web para o agente de História da Computação; o que permite aos utilizadores enviar prompts ao agente.

Captura de ecrã de uma aplicação cliente agente no Visual Studio Code.

A aplicação cliente pode incluir qualquer experiência de utilizador ou lógica de aplicação que o seu cenário requer. Independentemente do seu design, a interação central com o agente segue o mesmo padrão:

  1. Autentique e crie um cliente para o endpoint do agente.
  2. Submeta o pedido do utilizador através da API de Respostas.
  3. Processe a resposta e apresente-a ao utilizador ou a outro componente da aplicação.

Utilizar o SDK da OpenAI

O exemplo seguinte em Python utiliza DefaultAzureCredential para obter um token de acesso do Microsoft Entra e cria um cliente OpenAI configurado para o endpoint do agente. Em seguida, envia um prompt através de client.responses.create e apresenta a resposta de texto do agente.

from azure.identity import DefaultAzureCredential, get_bearer_token_provider
from openai import OpenAI

# Get an OpenAI client for the agent
token = get_bearer_token_provider(
    DefaultAzureCredential(), 
    "https://ai.azure.com/.default")

client = OpenAI(
    api_key=token,
    base_url="https://ai-resrce.services.ai.azure.com/api/projects/ai-project/agents/computinghistorycode/endpoint/protocols/openai",
    default_query={"api-version": "v1"}) 

# Submit a prompt to the agent and print the response
response = client.responses.create(
    input="Who was Grace Hopper?")

print(response.output_text)

DefaultAzureCredential Suporta múltiplas fontes de credenciais, permitindo que o mesmo código de aplicação seja autenticado em desenvolvimento local e num ambiente alojado. A identidade autenticada deve ter permissão para usar o projeto e o agente da Foundry.

A API Respostas proporciona uma forma consistente para aplicações e serviços interagirem com modelos e agentes. Ao expor agentes através de um endpoint compatível com OpenAI, o Foundry permite-lhe usar padrões SDK familiares enquanto o modelo, instruções e ferramentas do agente permanecem geridos no Foundry.