Gyorsindítás: A Feladatbetartás használata az ügynök-munkafolyamatokban

Ebben a rövid útmutatóban a Feladatbetartás funkciót használja. Az ügynök-munkafolyamatokhoz készült Task Adherence API biztosítja, hogy az AI-ügynökök olyan eszközműveleteket hajtsanak végre, amelyek igazodnak a felhasználó utasításaihoz és szándékához. Ez a funkció segít észlelni és megelőzni azokat a helyzeteket, amikor egy ügynök nem szándékos vagy idő előtti műveletet hajt végre, különösen akkor, ha olyan eszközöket invokál, amelyek hatással vannak a felhasználói adatokra, nagy kockázatú műveleteket hajtanak végre, vagy külső műveleteket kezdeményeznek.

A feladatbetartás olyan rendszerekben hasznos, amelyekben az ügynökök önállóan terveznek és cselekednek. Annak ellenőrzésével, hogy a tervezett eszközmeghívások megfelelnek-e a felhasználói és a feladatutasításoknak, és megjelöli a nem megfelelő eszközhasználatot, a Task Adherence segít fenntartani a rendszer megbízhatóságát, a felhasználói megbízhatóságot és a biztonságot.

A feladatbetartás működésével kapcsolatos további információkért tekintse meg a Tevékenységbetartási fogalmak lapot.

Előfeltételek

Feladatbetartás alkalmazása

Kövesse az alábbi lépéseket a Tartalombiztonság kipróbálása oldalon található feladatkövetés használatához:

  1. Nyissa meg az Azure AI Foundryt (klasszikus), és keresse meg a projektet/központot. Ezután válassza a bal oldali navigációs sávon a Guardrails + vezérlők lapot, majd a Kipróbálás lapot.
  2. A Kipróbálás lapon kísérletezhet a különféle Guardrails > vezérlőkkel, például a szöveg- és képtartalommal, és állítható küszöbértékekkel szűrheti a nem megfelelő vagy káros tartalmakat.
  3. Lépjen az Ügynöki munkafolyamat szakaszra, és válassza a Feladatbetartás panelt .
  4. A következő lapon kiválaszthat egy példát az összehangolt vagy nem összehangolt ügynök eszközhívások közül, vagy létrehozhat egy sajátot a feladatok teljesítésének tesztelésére.
  5. Válassza a Teszt futtatása lehetőséget. A Task Adherence minden mintához visszaadja a kockázatjelzőt, és ha kockázat észlelhető, az okot ad vissza.

Előfeltételek

  • Azure-előfizetés – Hozzon létre egyet ingyenesen
  • Miután megkapta az Azure-előfizetését, az Azure Portalon a kulcs és a végpont lekéréséhez. Adja meg az erőforrás egyedi nevét, válassza ki az előfizetését, és válasszon egy erőforráscsoportot, régiót és támogatott tarifacsomagot. Ezután válassza a Létrehozás lehetőséget.
    • Az erőforrás üzembe helyezése néhány percet vesz igénybe. A befejezés után válassza az Erőforrás megnyitása lehetőséget. A bal oldali panel Erőforrás-kezelés területén válassza az Előfizetési kulcsot és a Végpontot. A végpont és a kulcsok bármelyike az API-k meghívására szolgál.
  • telepített cURL

Feladat-betartás használata

A következő szakasz végigvezet egy mintakérésen a cURL használatával.

Illessze be az alábbi parancsot egy szövegszerkesztőbe, és végezze el a következő módosításokat.

  1. Cserélje le <endpoint> az erőforrásvégpont URL-címét.
  2. Írja felül a <your_subscription_key> változót a saját kulcsával.
  3. Ha szeretné, módosíthatja a szövegtörzs mezőjének szövegét "messages" a különböző forgatókönyvek teszteléséhez.
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."
  }
 ]
}'

Az alábbi mezőknek szerepelnie kell az URL-címben:

Név Szükséges? Description Típus
API-verzió Kötelező Ezt az API-verziót kell ellenőrizni. Jelenlegi verzió: 2025-09-15-preview. Példa: <endpoint>/contentsafety/image:analyze?api-version=2025-09-15-preview Lánc

A kérelem törzsének paramétereit ebben a táblában definiáljuk:

Név Szükséges? Description Típus
eszközök Igen A feladatban használandó függvényeket meghatározó eszközök listája. Minden eszköz tartalmaz egy type (például "függvény") és a függvény részleteit, beleértve a függvényt name és descriptiona . JSON-objektumok tömbje
messages Igen A felhasználó, az asszisztens és az eszközök között kicserélt üzenetek listája. Minden üzenet tartalmazza a source (például "Prompt", "Completion"), role (például "User", "Assistant", "Tool"), contents (üzenetszöveg) és opcionálisan toolCalls vagy toolCallId. JSON-objektumok tömbje

Nyisson meg egy parancssori ablakot, és futtassa a cURL parancsot.

Kimenet

A kérés elküldése után JSON-adatokat fog kapni, amelyek tükrözik a Task Adherence által végzett elemzést. Ezek az adatok jelölik az ügynök munkafolyamatának lehetséges biztonsági réseit. Így néz ki egy tipikus kimenet:

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

A kimenet JSON-mezői itt vannak definiálva:

Név Description Típus
Feladatkockázat Észlelt A bemenet kockázatészlelési eredményeit tartalmazza. logikai
details Érvelést ad vissza, ha a rendszer kockázatokat észlel Lánc

Az taskRiskDetected érték true egy észlelt kockázatot jelez, ebben az esetben javasoljuk a felülvizsgálatot és a szükséges lépéseket, például az eszközhívási kérelem blokkolását vagy az ember bevonását az eszkalációba.

Erőforrások tisztítása

Ha törölni és eltávolítani szeretne egy Azure AI-szolgáltatási előfizetést, törölheti az erőforrást vagy az erőforráscsoportot. A forráscsoport törlése azt is eredményezi, hogy bármely hozzá tartozó egyéb erőforrás is törlésre kerül.

Kapcsolódó tartalom

  • Utolsó frissítés időpontja: