Tworzenie aplikacji klienckiej dla agenta sztucznej inteligencji

Agent w Microsoft Foundry hermetyzuje model, instrukcje i narzędzia, których potrzebuje do wykonywania zadań. Aby udostępnić agenta użytkownikom, możesz utworzyć aplikację kliencką, która przesyła monity do agenta i przetwarza jego odpowiedzi.

Nawiązywanie połączenia z agentem

Uruchomiony agent w usłudze Foundry udostępnia punkt końcowy, który obsługuje protokół OpenAI Responses. Aplikacje mogą łączyć się z tym punktem końcowym przy użyciu zestawu OpenAI SDK, a użytkownicy lub tożsamości aplikacji z odpowiednimi uprawnieniami mogą uwierzytelniać się przy użyciu Microsoft Entra ID.

Można na przykład utworzyć aplikację internetową dla agenta historii obliczeń; umożliwia użytkownikom przesyłanie monitów do agenta.

Aplikacja kliencka może zawierać dowolne środowisko użytkownika lub logikę aplikacji wymaganą przez twój scenariusz. Niezależnie od jego projektu podstawowa interakcja z agentem jest zgodna z tym samym wzorcem:

1. Uwierzytelnij i utwórz klienta dla punktu końcowego agenta.
2. Prześlij prompt użytkownika za pomocą Responses API.
3. Przetwórz odpowiedź i przedstawij ją użytkownikowi lub innemu składnikowi aplikacji.

Korzystanie z zestawu OpenAI SDK

Poniższy przykład w języku Python używa elementu DefaultAzureCredential, aby uzyskać token dostępu Microsoft Entra, i tworzy klienta OpenAI skonfigurowanego dla punktu końcowego agenta. Następnie przesyła polecenie przez client.responses.create i wyświetla tekstową odpowiedź agenta.

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 obsługuje wiele źródeł poświadczeń, włączając ten sam kod aplikacji do uwierzytelniania w środowisku lokalnym i w środowisku hostowanym. Uwierzytelniona tożsamość musi mieć uprawnienie do korzystania z projektu i agenta Foundry.

Interfejs API odpowiedzi zapewnia spójny sposób interakcji aplikacji i usług z modelami i agentami. Uwidaczniając agentów za pośrednictwem punktu końcowego zgodnego z platformą OpenAI, narzędzie Foundry umożliwia korzystanie ze znanych wzorców zestawu SDK, podczas gdy model, instrukcje i narzędzia agenta pozostają zarządzane w rozwiązaniu Foundry.