Agent-Konzepte

Ein Agent Framework-Agent kombiniert eine Agent-Abstraktion, ein Modell oder eine Remote-Agent-Verbindung, Anweisungen, Tools, Middleware, Kontextanbieter und Sitzungsstatus hinter einer konsistenten Ausführungsschnittstelle.

Laufzeit und Ausführung

  • Agenten ausführen erläutert reguläre und Streaming-Ausführungen, Ausführungsoptionen, Antworten, Nachrichten und Inhalte.
  • Die Agentpipeline erläutert, wie Middleware, Kontextanbieter, Modellaufrufe und Tools an einer Ausführung teilnehmen.

Agenttypen

  • Benutzerdefinierte Agents erläutern die allgemeine Agent-Schnittstelle und wann ein Agent direkt implementiert werden soll.
  • Modellanbieter verbinden anwendungseigene Agents mit Rückschlussdiensten.
  • Agentdienste stellen eine Verbindung mit verwalteten oder protokollgestützten Remote-Agents her.

Agenten für Chat-Clients

Chat-Client-Agents sind anwendungseigene Agents, die von einem Modell-Ableitungsclient unterstützt werden. Sie unterstützen Tools für Funktionsaufrufe, Konversationen über mehrere Runden, anbietergehostete Tools, sofern verfügbar, strukturierte Ausgaben, Streaming, Middleware sowie eine lokale oder dienstverwaltete Konversationshistorie.

Jeder Inference-Client, der Microsoft.Extensions.AI.IChatClient implementiert, kann ein ChatClientAgent unterstützen:

using Microsoft.Agents.AI;

AIAgent agent = new ChatClientAgent(
    chatClient,
    instructions: "You are a helpful assistant.");

Alle Agentimplementierungen teilen die AIAgent Abstraktion, sodass Anwendungscode und Orchestrierungen mit Chat-Client-Agents, benutzerdefinierten Agents und Remote-Agent-Proxys über eine Schnittstelle arbeiten können.

Informationen zu Anbieterfunktionen, zur Unterstützung für den Konversationsverlauf und zur Auswahl des SDK-Endpunkts finden Sie unter Modellanbieter.

Erstellen Sie ein Standard-Agent aus einem beliebigen Client, der SupportsChatGetResponse implementiert:

from agent_framework import Agent

agent = Agent(
    client=client,
    instructions="You are a helpful assistant.",
)

Die gleiche Agent Schnittstelle funktioniert über unterstützte Modellanbieter hinweg. Direkte Agent-Typen wie FoundryAgent, A2AAgent, GitHubCopilotAgent und ClaudeAgent stellen stattdessen eine Verbindung zu verwalteten oder Remote-Agent-Runtimes her.

Informationen zu verfügbaren Rückschlussclients finden Sie unter "Modellanbieter".

Go-Model-Provider-Pakete konstruieren den Standardtyp *agent.Agent mithilfe anbieterspezifischer Konstruktoren. Dadurch erhält der Anwendungscode eine einheitliche Schnittstelle für Ausführungen, Sitzungen, Tools, Middleware und Streaming, wobei jeder Anbieter die Client-Initialisierung selbst übernimmt.

Informationen zu Konstruktoren und Importpfaden finden Sie unter Modellanbieter.

Unterhaltungen und Arbeitsspeicher

Konversationskonzepte umfassen Sitzungen, Kontextanbieter, Speicherung, Kompaktierung und den integrierten Speicheranbieter für den Chatverlauf.

Middleware

Middleware-Konzepte umfassen Definition, Geltungsbereich, Reihenfolge, gemeinsam genutzten Status, Laufzeitkontext, Beendigung, Fehler und das Überschreiben von Ergebnissen.

Safety

Die Agentsicherheit beschreibt Entwurfsmuster zum Einschränken des Agentverhaltens und zur Verringerung des Betriebsrisikos. Die Durchsetzung von Sicherheitsrichtlinien mit FIDES bleibt eine Agent-Fähigkeit.

Nächste Schritte