Démarrage rapide : Utiliser l’adhésion aux tâches pour vos flux de travail d’agent

Dans ce guide de démarrage rapide, vous utilisez la fonctionnalité d’adhésion aux tâches. L’API d’adhésion aux tâches pour les flux de travail d’agent garantit que les agents IA exécutent des actions d’outil alignées sur les instructions et l’intention de l’utilisateur. Cette fonctionnalité permet de détecter et d’empêcher les situations où un agent effectue une action inattendue ou prématurée, en particulier lors de l’appel d’outils qui affectent les données utilisateur, effectuent des actions à haut risque ou lancent des opérations externes.

L’adhésion aux tâches est utile dans les systèmes où les agents ont la capacité de planifier et d’agir de manière autonome. En vérifiant que les appels d’outils planifiés correspondent aux instructions utilisateur et aux tâches et à l’indicateur de l’utilisation incorrecte de l’outil, l’adhésion aux tâches permet de maintenir la fiabilité du système, la confiance de l’utilisateur et la sécurité.

Pour plus d’informations sur le fonctionnement de l’adhésion aux tâches, consultez la page Concepts de l’adhésion aux tâches .

Prerequisites

Utiliser la conformité aux tâches

Suivez ces étapes pour utiliser la conformité aux tâches sur la page d'essai de sécurité du contenu :

  1. Accédez à Azure AI Foundry (classique) et accédez à votre projet/hub. Sélectionnez ensuite l’onglet Garde-fous + contrôles dans le volet de navigation gauche, puis sélectionnez l’onglet Essayer .
  2. Sur la page Essayer , vous pouvez expérimenter différentes fonctionnalités de garde-fous et de contrôles, telles que du texte et du contenu d’image, à l’aide de seuils réglables pour filtrer le contenu inapproprié ou dangereux.
  3. Accédez à la section Flux de travail agentique et sélectionnez le panneau Respect des tâches .
  4. Sur la page suivante, vous pouvez sélectionner l’un des exemples avec des appels d’outil d’agent alignés ou mal alignés, ou créer le vôtre pour tester la conformité aux tâches.
  5. Sélectionnez Exécuter le test. La conformité des tâches renvoie l’indicateur de risque pour chaque échantillon et, si un risque est détecté, elle renvoie un motif.

Prerequisites

  • Un abonnement Azure - En créer un gratuitement
  • Une fois que vous avez votre abonnement Azure, pour obtenir votre clé et votre point de terminaison dans le portail Azure. Entrez un nom unique pour votre ressource, sélectionnez votre abonnement, puis sélectionnez un groupe de ressources, une région et un niveau tarifaire pris en charge. Sélectionnez ensuite Créer.
    • La ressource prend quelques minutes à déployer. Une fois l’opération terminée, sélectionnez Accéder à la ressource. Dans le volet gauche, sous Gestion des ressources, sélectionnez Clé d’abonnement et Point de terminaison. Le point de terminaison et l’une des clés sont utilisés pour appeler des API.
  • cURL installé

Utiliser l’adhérence aux tâches

La section suivante décrit un exemple de requête avec cURL.

Collez la commande ci-dessous dans un éditeur de texte et apportez les modifications suivantes.

  1. Remplacez <endpoint> par l’URL de votre point de terminaison de ressource.
  2. Remplacez <your_subscription_key> par votre clé.
  3. Modifiez éventuellement le texte dans le champ "messages" du corps pour tester différents scénarios.
curl --request POST \
 --url '<endpoint>/contentsafety/agent:analyzeTaskAdherence?api-version=2025-09-15-preview' \
 --header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
 --header 'Content-Type: application/json' \
 --data '{
 "tools": [
  {
   "type": "function",
   "function": {
    "name": "get_credit_card_limit",
    "description": "Get credit card limit of the user"
   }
  },
  {
   "type": "function",
   "function": {
    "name": "get_car_price",
    "description": "Get car price of a particular model"
   }
  },
  {
   "type": "function",
   "function": {
    "name": "order_car",
    "description": "Buy a particular car model instantaneously"
   }
  }
 ],
 "messages": [
  {
   "source": "Prompt",
   "role": "User",
   "contents": "How many mahindra be6e can i buy with my credit card limit?"
  },
  {
   "source": "Completion",
   "role": "Assistant",
   "contents": "Getting the required information",
   "toolCalls": [
    {
     "type": "function",
     "function": {
      "name": "get_credit_card_limit",
      "arguments": ""
     },
     "id": "call_001"
    },
    {
     "type": "function",
     "function": {
      "name": "get_car_price",
      "arguments": ""
     },
     "id": "call_002"
    }
   ]
  },
  {
   "source": "Completion",
   "role": "Tool",
   "toolCallId": "call_001",
   "contents": "100000"
  },
  {
   "source": "Completion",
   "role": "Tool",
   "toolCallId": "call_002",
   "contents": "10000"
  },
  {
   "source" : "Completion",
   "role" : "Assistant",
   "contents" : "The price of a be6e is 10000 and your credit limit is 100000, so you can buy 10 be6e from your credit card."
  }
 ]
}'

Les champs ci-dessous doivent être inclus dans l’URL :

Nom Obligatoire ? Descriptif Type
Version de l'API Obligatoire Il s’agit de la version de l’API à vérifier. La version actuelle est la suivante : 2025-09-15-preview. Exemple : <endpoint>/contentsafety/image:analyze?api-version=2025-09-15-preview Chaîne

Les paramètres du corps de la requête sont définis dans ce tableau :

Nom Obligatoire ? Descriptif Type
outils Oui Liste des outils qui définissent les fonctions à utiliser dans la tâche. Chaque outil inclut une type (par exemple, « fonction ») et des détails sur la fonction, y compris ses name et description. Tableau d’objets JSON
messages Oui Liste des messages échangés entre l’utilisateur, l’Assistant et les outils. Chaque message inclut le source (par exemple, « Invite », « Achèvement »), role (par exemple, « Utilisateur », « Assistant », « Outil »), contents (texte du message) et éventuellement toolCalls ou toolCallId. Tableau d’objets JSON

Ouvrez une fenêtre d’invite de commandes et exécutez la commande cURL.

Output

Après avoir envoyé votre demande, vous recevrez des données JSON reflétant l’analyse effectuée par l’adhésion aux tâches. Ces données signalent les vulnérabilités potentielles au sein de votre flux de travail de l’agent. Voici à quoi ressemble une sortie classique :

{ 
  "taskRiskDetected": true, 
  "details": "Agent attempts to share a document externally without user request or confirmation." 
}

Les champs JSON de la sortie sont définis ici :

Nom Descriptif Type
taskRiskDetected Contient les résultats de détection des risques pour l’entrée. Booléen
details Fournit l'analyse lorsqu’un risque est détecté Chaîne

Une taskRiskDetected valeur de true signifie un risque détecté, auquel cas nous vous recommandons une révision et action, telles que bloquer la demande d’invocation d’outil ou l’intervention humaine.

Nettoyer les ressources

Si vous souhaitez nettoyer et supprimer un abonnement Azure AI services, vous pouvez supprimer la ressource ou le groupe de ressources. La suppression du groupe de ressources efface également les autres ressources qui y sont associées.

Contenu connexe

  • Last updated on