Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Un agente dell’Agent Framework combina un’astrazione dell’agente, un modello o una connessione a un agente remoto, istruzioni, strumenti, middleware, provider di contesto e stato della sessione dietro un’interfaccia di esecuzione uniforme.
Runtime ed esecuzione
- Gli agenti in esecuzione illustrano le esecuzioni regolari e di streaming, le opzioni di esecuzione, le risposte, i messaggi e il contenuto.
- La pipeline dell'agente spiega in che modo il middleware, i provider di contesto, la chiamata al modello e gli strumenti partecipano a un'esecuzione.
Tipi di agente
- Gli agenti personalizzati illustrano l'interfaccia dell'agente comune e quando implementare direttamente un agente.
- I fornitori di modelli connettono gli agenti gestiti dall'applicazione ai servizi di inferenza.
- I servizi agente si connettono a agenti remoti gestiti o supportati dal protocollo.
Agenti client di chat
Gli agenti client di chat sono agenti di proprietà dell'applicazione supportati da un client di inferenza del modello. Supportano strumenti per le funzioni, conversazioni a più turni, strumenti ospitati dal provider, dove disponibili, output strutturati, streaming, middleware e cronologia delle conversazioni locali o gestite dal servizio.
Qualsiasi client di inferenza che implementa Microsoft.Extensions.AI.IChatClient può eseguire il backup di un oggetto ChatClientAgent:
using Microsoft.Agents.AI;
AIAgent agent = new ChatClientAgent(
chatClient,
instructions: "You are a helpful assistant.");
Tutte le implementazioni dell'agente condividono l'astrazione AIAgent , in modo che il codice dell'applicazione e le orchestrazioni possano funzionare con agenti client chat, agenti personalizzati e proxy di agente remoto tramite un'unica interfaccia.
Per le funzionalità del provider, il supporto della cronologia delle conversazioni e la selezione degli endpoint SDK, vedere Provider di modelli.
Creare uno standard Agent da qualsiasi client che implementi SupportsChatGetResponse:
from agent_framework import Agent
agent = Agent(
client=client,
instructions="You are a helpful assistant.",
)
La stessa Agent interfaccia funziona tra provider di modelli supportati. Tipi di agenti diretti come FoundryAgent, A2AAgent, GitHubCopilotAgent e ClaudeAgent si collegano invece a runtime di agenti gestiti o remoti.
Per i client di inferenza disponibili, vedere Provider di modelli.
I pacchetti del provider di modelli Go costruiscono il tipo standard *agent.Agent tramite costruttori specifici del provider. In questo modo, il codice dell'applicazione fornisce un'interfaccia coerente per esecuzione, sessione, strumenti, middleware e streaming, mentre ogni provider gestisce l'inizializzazione del client.
Per i costruttori e i percorsi di importazione, vedere Provider di modelli.
Conversazioni e memoria
I concetti relativi alle conversazioni comprendono sessioni, provider di contesto, archiviazione, compattazione e il provider di memoria integrato per la cronologia delle chat.
Middleware
I concetti del middleware riguardano la definizione, l'ambito, l'ordinamento, lo stato condiviso, il contesto di runtime, la terminazione, gli errori e gli override dei risultati.
Safety
La sicurezza dell'agente descrive i modelli di progettazione per vincolare il comportamento dell'agente e ridurre il rischio operativo. L'applicazione della sicurezza con FIDES rimane una funzionalità dell'agente.