Utveckla en klientapp för en AI-agent

  • 5 minuter

Tip

Mer information finns på fliken Text och bilder !

En agent i Microsoft Foundry kapslar in den modell, de instruktioner och verktyg som krävs för att utföra uppgifter. För att göra agenten tillgänglig för användare kan du skapa ett klientprogram som skickar frågor till agenten och bearbetar dess svar.

Ansluta till en agent

En agent som körs i Foundry tillhandahåller en slutpunkt som stöder OpenAI Responses-protokollet. Program kan ansluta till den här slutpunkten med hjälp av OpenAI SDK, och användare eller programidentiteter med lämpliga behörigheter kan autentisera med hjälp av Microsoft Entra ID.

Du kan till exempel utveckla ett webbprogram för databehandlingshistorikagenten. som gör det möjligt för användare att skicka frågor till agenten.

Skärmbild av ett agentklientprogram i Visual Studio Code.

Klientprogrammet kan innehålla alla användarupplevelser eller programlogik som ditt scenario kräver. Oavsett design följer kärninteraktionen med agenten samma mönster:

  1. Autentisera och skapa en klient för agentslutpunkten.
  2. Skicka användarens uppmaning med hjälp av svars-API:et.
  3. Bearbeta svaret och presentera det för användaren eller en annan programkomponent.

Använda OpenAI SDK

Följande Python-exempel använder DefaultAzureCredential för att hämta en Microsoft Entra-åtkomsttoken och skapar en OpenAI-klient som är konfigurerad för agentens ändpunkt. Den skickar sedan en uppmaning genom client.responses.create och skriver ut agentens textsvar.

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 stöder flera källor för autentiseringsuppgifter, vilket gör att samma programkod kan autentiseras i lokal utveckling och i en värdbaserad miljö. Den autentiserade identiteten måste ha behörighet att använda Foundry-projektet och agenten.

Svars-API:et är ett konsekvent sätt för program och tjänster att interagera med modeller och agenter. Genom att exponera agenter via en OpenAI-kompatibel slutpunkt kan Foundry använda välbekanta SDK-mönster medan agentens modell, instruktioner och verktyg förblir hanterade i Foundry.