Dela via

REST API-referens för Azure AI Foundry Agent-tjänsten

Azure AI Foundry Agent Service REST API tillhandahåller slutpunkter för att skapa, konfigurera och köra AI-agenter. Dessa agenter är molnbaserade tjänster som parar ihop stora språkmodeller (LLM) med verktyg för att läsa data, anropa funktioner och köra logik för din räkning. Tjänsten hanteras helt av Azure, så du kan fokusera på att skapa intelligenta arbetsflöden utan att hantera infrastrukturen.

API:et följer samma protokoll som Azure OpenAI Assistants API. På så sätt kan du använda befintliga OpenAI-kompatibla verktyg och SDK:er med minimala konfigurationsändringar.

Mer information om tjänsten finns i dokumentationen för Azure AI Agent Service.

REST-åtgärdsgrupper

API-åtgärderna grupperas efter grundläggande begrepp. Använd innehållsförteckningen till vänster för att bläddra bland tillgängliga slutpunkter. Viktiga åtgärdsgrupper är:

  • Handläggare – Skapa, hämta, uppdatera eller ta bort en handläggardefinition. En agent innehåller modellen, instruktionerna och verktygskonfigurationen.
  • Trådar – Skapa eller lista konversationstrådar. En tråd representerar meddelandehistoriken för en interaktion.
  • Meddelanden – Lägg till eller hämta meddelanden i en tråd. Meddelanden kan komma från användaren eller agenten.
  • Körningar – Starta en agentkörning på en tråd. En körning bearbetar tråden och kan anropa verktyg under körningen.
  • Körningssteg – Inspektera enskilda åtgärder som utförs under en körning, till exempel verktygsanrop eller modellanrop.
  • Verktyg – Registrera och hantera anpassade verktyg som definieras av OpenAPI-specifikationerna.

Autentisering

Agenttjänsten stöder Microsoft Entra ID-token för autentisering. Azure-resursnycklar stöds inte ännu.

Åtkomsten styrs av rollbaserad åtkomstkontroll i Azure (RBAC). Mer information finns i Vad är rollbaserad åtkomstkontroll i Azure (Azure RBAC?) och Rollbaserad åtkomstkontroll för Azure AI Foundry.

Se även