Een client-app ontwikkelen voor een AI-agent
Tip
Zie het tabblad Tekst en afbeeldingen voor meer informatie.
Een agent in Microsoft Foundry bevat het model, de instructies en hulpprogramma's die nodig zijn om taken uit te voeren. Als u de agent beschikbaar wilt maken voor gebruikers, kunt u een clienttoepassing bouwen waarmee prompts naar de agent worden verzonden en de antwoorden worden verwerkt.
Verbinding maken met een agent
Een actieve agent in Foundry biedt een eindpunt dat ondersteuning biedt voor het OpenAI-antwoordprotocol. Toepassingen kunnen verbinding maken met dit eindpunt met behulp van de OpenAI SDK en gebruikers of toepassingsidentiteiten met de juiste machtigingen kunnen worden geverifieerd met behulp van Microsoft Entra ID.
U kunt bijvoorbeeld een webtoepassing ontwikkelen voor de Computing History-agent; waarmee gebruikers prompts naar de agent kunnen verzenden.
De clienttoepassing kan elke gebruikerservaring of toepassingslogica bevatten die uw scenario vereist. Ongeacht het ontwerp volgt de belangrijkste interactie met de agent hetzelfde patroon:
- Verifieer en maak een client voor het agenteindpunt.
- Verzend de prompt van de gebruiker met behulp van de Antwoorden-API.
- Verwerk het antwoord en presenteer het aan de gebruiker of een ander toepassingsonderdeel.
De OpenAI SDK gebruiken
In het volgende Python-voorbeeld wordt met DefaultAzureCredential een Microsoft Entra-toegangstoken verkregen en wordt een OpenAI client gemaakt die is geconfigureerd voor het eindpunt van de agent. Vervolgens verzendt het via client.responses.create een prompt en drukt het het tekstantwoord van de agent af.
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 ondersteunt meerdere referentiebronnen, waardoor dezelfde toepassingscode kan worden geverifieerd bij lokale ontwikkeling en in een gehoste omgeving. De geverifieerde identiteit moet gemachtigd zijn om het Foundry-project en de agent te kunnen gebruiken.
De Response-API biedt een consistente manier voor toepassingen en services om te communiceren met modellen en agents. Door agents beschikbaar te maken via een openAI-compatibel eindpunt, kunt u met Foundry vertrouwde SDK-patronen gebruiken terwijl het model, de instructies en hulpprogramma's van de agent worden beheerd in Foundry.