Développer une application cliente pour un agent IA

  • 5 minutes

Tip

Pour plus d’informations, consultez l’onglet Texte et images !

Un agent dans Microsoft Foundry encapsule le modèle, les instructions et les outils dont il a besoin pour effectuer des tâches. Pour rendre l’agent accessible aux utilisateurs, vous pouvez créer une application cliente qui envoie des invites à l’agent et traite ses réponses.

Se connecter à un agent

Un agent en cours d’exécution dans Foundry fournit un point de terminaison qui prend en charge le protocole Réponses OpenAI. Les applications peuvent se connecter à ce point de terminaison à l’aide du Kit de développement logiciel (SDK) OpenAI, et les utilisateurs ou les identités d’application disposant d’autorisations appropriées peuvent s’authentifier à l’aide de Microsoft Entra ID.

Par exemple, vous pouvez développer une application web pour l’agent d’historique informatique ; qui permet aux utilisateurs d’envoyer des invites à l’agent.

Capture d’écran d’une application cliente agent dans Visual Studio Code.

L’application cliente peut inclure n’importe quelle expérience utilisateur ou logique d’application requise par votre scénario. Quelle que soit sa conception, l’interaction principale avec l’agent suit le même modèle :

  1. Authentifiez et créez un client pour le point de terminaison de l’agent.
  2. Envoyez l’invite de l’utilisateur à l’aide de l’API Réponses.
  3. Traitez la réponse et présentez-la à l’utilisateur ou à un autre composant d’application.

Utiliser le Kit de développement logiciel (SDK) OpenAI

L'exemple de Python suivant utilise DefaultAzureCredential pour obtenir un jeton d'accès Microsoft Entra et créer un OpenAI client configuré pour le point de terminaison de l'agent. Il envoie ensuite une invite via client.responses.create et imprime la réponse texte de l’agent.

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 prend en charge plusieurs sources d’informations d’identification, ce qui permet au même code d’application de s’authentifier dans le développement local et dans un environnement hébergé. L’identité authentifiée doit avoir l’autorisation d’utiliser le projet et l’agent Foundry.

L’API Réponses offre un moyen cohérent pour les applications et les services d’interagir avec des modèles et des agents. En exposant des agents via un point de terminaison compatible OpenAI, Foundry vous permet d’utiliser des modèles sdk familiers pendant que le modèle, les instructions et les outils de l’agent restent gérés dans Foundry.