Desenvolver um aplicativo cliente para um agente de IA

  • 5 minutos

Dica

Consulte a guia Texto e imagens para obter mais detalhes!

Um agente no Microsoft Foundry encapsula o modelo, as instruções e as ferramentas de que ele precisa para executar tarefas. Para disponibilizar o agente aos usuários, você pode criar um aplicativo cliente que envia prompts ao agente e processa suas respostas.

Conectar-se a um agente

Um agente em execução no Foundry fornece um endpoint compatível com o protocolo Responses da OpenAI. Os aplicativos podem se conectar a esse ponto de extremidade usando o SDK do OpenAI e usuários ou identidades de aplicativo com permissões apropriadas podem se autenticar usando Microsoft Entra ID.

Por exemplo, você pode desenvolver um aplicativo Web para o agente de Histórico de Computação; que permite que os usuários enviem prompts ao agente.

Captura de tela de um aplicativo cliente do agente no Visual Studio Code.

O aplicativo cliente pode incluir qualquer experiência do usuário ou lógica de aplicativo necessária para seu cenário. Independentemente de seu design, a interação principal com o agente segue o mesmo padrão:

  1. Autentique e crie um cliente para o endpoint do agente.
  2. Envie o prompt do usuário usando a API de Respostas.
  3. Processe a resposta e apresente-a ao usuário ou a outro componente do aplicativo.

Usar o SDK do OpenAI

O exemplo de Python a seguir usa DefaultAzureCredential para obter um token de acesso do Microsoft Entra e cria um cliente OpenAI configurado para o endpoint do agente. Em seguida, ele envia um prompt por meio de client.responses.create e exibe a resposta textual 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 dá suporte a várias fontes de credencial, permitindo que o mesmo código de aplicativo se autentique no desenvolvimento local e em um ambiente hospedado. A identidade autenticada deve ter permissão para usar o projeto e o agente do Foundry.

A API de Respostas fornece uma maneira consistente para aplicativos e serviços interagirem com modelos e agentes. Ao expor agentes por meio de um ponto de extremidade compatível com OpenAI, o Foundry permite que você use padrões de SDK familiares enquanto o modelo, as instruções e as ferramentas do agente permanecem gerenciados na Foundry.