Freigeben über

REST-API-Referenz für den Azure AI Foundry-Agent-Dienst

Die REST-API des Azure AI Foundry-Agent-Diensts stellt Endpunkte zum Erstellen, Konfigurieren und Ausführen von KI-Agents bereit. Bei diesen Agents handelt es sich um in der Cloud gehostete Dienste, die große Sprachmodelle (LLMs) mit Tools zum Lesen von Daten, Aufrufen von Funktionen und Ausführen von Logik in Ihrem Namen kombinieren. Der Dienst wird vollständig von Azure verwaltet, sodass Sie sich auf die Erstellung intelligenter Workflows konzentrieren können, ohne die Infrastruktur verwalten zu müssen.

Die API folgt dem gleichen Protokoll wie die Azure OpenAI Assistants-API. Auf diese Weise können Sie vorhandene OpenAI-kompatible Tools und SDKs mit minimalen Konfigurationsänderungen verwenden.

Weitere Informationen zum Dienst finden Sie in der Dokumentation zum Azure AI-Agent-Dienst.

REST-Vorgangsgruppen

Die API-Operationen sind nach Kernkonzepten gruppiert. Verwenden Sie das Inhaltsverzeichnis auf der linken Seite, um die verfügbaren Endpunkte zu durchsuchen. Zu den wichtigsten Vorgangsgruppen gehören:

  • Agenten – Erstellen, Abrufen, Aktualisieren oder Löschen einer Agentendefinition. Ein Agent enthält das Modell, die Anweisungen und die Werkzeugkonfiguration.
  • Threads – Erstellen oder listen Sie Unterhaltungsthreads auf. Ein Thread stellt den Nachrichtenverlauf für eine Interaktion dar.
  • Nachrichten – Fügen Sie Nachrichten innerhalb eines Threads hinzu oder rufen Sie sie ab. Nachrichten können vom Benutzer oder vom Agenten stammen.
  • Wird ausgeführt – Starten Sie eine Agent-Ausführung in einem Thread. Bei einer Ausführung wird der Thread verarbeitet und während der Ausführung möglicherweise Tools aufgerufen.
  • Ausführungsschritte – Überprüfen Sie einzelne Aktionen, die während eines Laufs ausgeführt werden, z. B. Werkzeugaufrufe oder Modellaufrufe.
  • Tools – Registrieren und verwalten Sie benutzerdefinierte Tools, die durch OpenAPI-Spezifikationen definiert sind.

Authentifizierung

Der Dienst unterstützt sowohl Microsoft Entra ID-Token als auch Azure-Ressourcenschlüssel.

  • Verwenden Sie Microsoft Entra ID für sichere Produktionsbereitstellungen.
  • Verwenden Sie einen Ressourcenschlüssel für lokale Tests oder vertrauenswürdige Back-End-Dienste.

Der Zugriff wird durch die rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC) von Azure gesteuert. Weitere Informationen finden Sie unter Was ist die rollenbasierte Zugriffssteuerung in Azure (Azure Role-Based Access Control, Azure RBAC)?

Siehe auch