-----------------------------------

Acquista i software ArcGIS tramite Studio A&T srl, rivenditore autorizzato dei prodotti Esri.

I migliori software GIS, il miglior supporto tecnico!

I migliori software GIS, il miglior supporto tecnico!
Azienda operante nel settore GIS dal 2001, specializzata nell’utilizzo della tecnologia ArcGIS e aderente ai programmi Esri Italia Business Network ed Esri Partner Network

-----------------------------------



Visualizzazione post con etichetta AI Agents. Mostra tutti i post
Visualizzazione post con etichetta AI Agents. Mostra tutti i post

venerdì 16 ottobre 2026

Osservabilità degli agenti AI: Microsoft Agent Framework, OpenTelemetry e Azure Monitor

NicoGIS Tech Weekly | AI Engineering · .NET · Distributed Tracing · Azure

Osservabilità degli agenti AI: Microsoft Agent Framework, OpenTelemetry e Azure Monitor

Come ricostruire il percorso di esecuzione di un agente, correlare chiamate a LLM e tool, misurare latenza e token e individuare i colli di bottiglia nei sistemi agentici distribuiti.

Deep dive tecnico · 16 ottobre 2026 · Livello avanzato

Un agente AI non esegue semplicemente una richiesta verso un modello linguistico. Può pianificare operazioni, interrogare sistemi esterni, invocare strumenti, recuperare informazioni e ripetere le chiamate al modello prima di produrre una risposta. Questo cambia radicalmente il problema dell'osservabilità.

In una normale applicazione distribuita, il tracing permette di ricostruire il percorso di una richiesta HTTP attraverso servizi, database e code di messaggi. Nei sistemi agentici occorre estendere lo stesso modello a operazioni non necessariamente deterministiche, il cui numero e ordine possono variare tra un'esecuzione e l'altra.

La domanda non è soltanto quanto tempo abbia impiegato una richiesta, ma cosa abbia effettivamente fatto l'agente durante quel tempo.

1. Dall'osservabilità applicativa all'osservabilità agentica

Si consideri un agente incaricato di analizzare un documento aziendale e produrne una sintesi. Potrebbe essere necessaria una prima inferenza per definire il piano, una ricerca, il download del documento e una seconda inferenza per la risposta finale.

Una singola richiesta produce più operazioni correlate. Senza distributed tracing, eventi separati nei log non consentono sempre di ricostruire con certezza l'esecuzione. Con una trace distribuita si possono osservare modello invocato, tool, dipendenze HTTP e database, token, errori, retry e punti di maggiore latenza.

2. OpenTelemetry GenAI Semantic Conventions

OpenTelemetry organizza la telemetria in traces, metrics e logs. Le GenAI Semantic Conventions definiscono vocabolario e attributi per descrivere operazioni di modelli generativi, agenti e tool. Esempi di nomi di operazione includono:

OperazioneSignificato
invoke_agentInvocazione di un agente
chatInterazione conversazionale con un modello
execute_toolEsecuzione di uno strumento
invoke_workflowEsecuzione di un workflow agentico, se supportata dall'instrumentation adottata
planPianificazione, nei sistemi che la rappresentano esplicitamente
retrievalRecupero di informazioni, dove previsto dall'instrumentation

Alcuni attributi utili per analizzare un'esecuzione sono:

gen_ai.operation.name
gen_ai.agent.name
gen_ai.provider.name
gen_ai.request.model
gen_ai.tool.name
gen_ai.usage.input_tokens
gen_ai.usage.output_tokens

Attenzione alla compatibilità: le convenzioni agentiche sono un'area in evoluzione; denominazioni, stabilità e adozione degli attributi possono differire in base alla versione delle specifiche e dei pacchetti. Le operazioni sopra elencate non implicano che ogni runtime le emetta automaticamente. Verificare sempre le convenzioni ufficiali per gli agenti e quelle relative alle operazioni GenAI.

3. L'architettura: da Agent Framework ad Azure Monitor

Agent Framework e i client strumentati producono segnali. OpenTelemetry raccoglie e correla i dati. Gli exporter li inviano ai backend. Separare questi livelli riduce l'accoppiamento tra orchestrazione dell'agente e prodotto di monitoraggio.

4. Laboratorio .NET: configurare tracing e instrumentation

Un esempio ASP.NET Core può utilizzare la distribuzione Microsoft OpenTelemetry. Il comando per installare il pacchetto è:

dotnet add package Microsoft.OpenTelemetry

La configurazione esatta dipende dalla versione del pacchetto. Nelle versioni che espongono UseMicrosoftOpenTelemetry e ExportTarget, uno schema di configurazione è il seguente:

using Microsoft.OpenTelemetry;

var builder = WebApplication.CreateBuilder(args);

builder.UseMicrosoftOpenTelemetry(options =>
{
    options.Exporters =
        ExportTarget.AzureMonitor |
        ExportTarget.Otlp;
});

var app = builder.Build();
app.MapGet("/health", () => Results.Ok());
app.Run();

La destinazione Azure Monitor utilizza la connection string configurata nell'ambiente:

APPLICATIONINSIGHTS_CONNECTION_STRING

Per OTLP, quando usato, è possibile configurare:

OTEL_EXPORTER_OTLP_ENDPOINT

Questa configurazione abilita la pipeline, ma non crea alcun agente. Per generare span agentici occorre istanziare e invocare componenti effettivamente strumentati.

Instrumentare chat client e agente

Le versioni di Microsoft Agent Framework basate sull'API ChatClientAgent possono essere strumentate tramite UseOpenTelemetry() per il client e WithOpenTelemetry() per l'agente:

using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

// chatClient è un IChatClient già configurato.
IChatClient instrumentedClient = chatClient
    .AsBuilder()
    .UseOpenTelemetry()
    .Build();

var agent = new ChatClientAgent(
    instrumentedClient,
    name: "DocumentAnalyzer",
    instructions:
        "Analyze documents and report verified findings."
).WithOpenTelemetry();

Frammento focalizzato sull'instrumentation, non un progetto completo eseguibile. Microsoft Agent Framework è in evoluzione: controllare overload, namespace, pacchetti e metodo di creazione dell'agente rispetto alla versione NuGet installata.

Span personalizzati con ActivitySource

Per correlare operazioni applicative si può utilizzare System.Diagnostics.ActivitySource:

using System.Diagnostics;

public static class AgentTelemetry
{
    public const string SourceName =
        "NicoGIS.TechWeekly.AgentDemo";

    public static readonly ActivitySource Source =
        new(SourceName);

    public static async Task<T> TraceDocumentLoadAsync<T>(
        Func<Task<T>> loadDocument)
    {
        using var activity = Source.StartActivity(
            "document.load", ActivityKind.Internal);

        try
        {
            var result = await loadDocument();
            activity?.SetTag("document.operation", "load");
            return result;
        }
        catch (Exception ex)
        {
            activity?.SetStatus(
                ActivityStatusCode.Error, ex.Message);
            activity?.AddException(ex);
            throw;
        }
    }
}

La ActivitySource personalizzata deve essere aggiunta alla configurazione del tracing:

builder.Services.AddOpenTelemetry()
    .WithTracing(tracing =>
        tracing.AddSource(AgentTelemetry.SourceName));

Quando la nuova attività viene aperta in presenza di un contesto Activity.Current valido, il runtime stabilisce la relazione con lo span corrente. Le informazioni applicative possono usare attributi dedicati; le chiavi gen_ai.* vanno invece utilizzate nel rispetto delle convenzioni ufficiali.

5. TraceId, SpanId e propagazione del contesto

La correlazione si fonda sul contesto distribuito e, frequentemente, sugli header W3C Trace Context.

ElementoRuolo
TraceIdIdentifica l'intera esecuzione distribuita.
SpanIdIdentifica una singola operazione.
ParentSpanIdCollega lo span a quello padre.
traceparentPropaga il contesto tra servizi.
tracestateVeicola informazioni supplementari del contesto.
HTTP POST /analyze
└── invoke_agent DocumentAnalyzer
    ├── chat (planning)
    ├── execute_tool ReadDocument
    │   └── HTTP GET /api/documents/42
    │       └── SQL SELECT ...
    └── chat (synthesis)

Con le instrumentation HTTP corrette, il contesto attraversa il confine tra client e servizio ricevente. Nel caso dei tool MCP non bisogna dare per scontata la propagazione: trasporto, client, server e intermediari devono supportarla. Quando manca, due segmenti della stessa esecuzione possono comparire come trace indipendenti.

6. Azure Monitor: analisi con KQL

In Application Insights collegato a un workspace Log Analytics, le dipendenze possono essere interrogate tramite la tabella AppDependencies. Per ricostruire gli eventi relativi a un OperationId:

let traceId = "INSERT_TRACE_ID";
AppDependencies
| where OperationId == traceId
| project
    TimeGenerated,
    Name,
    DependencyType,
    DurationMs,
    Success,
    OperationId,
    ParentId,
    Id,
    Properties
| order by TimeGenerated asc

Per identificare le dipendenze con maggiore latenza al 95° percentile:

AppDependencies
| where TimeGenerated > ago(24h)
| summarize
    Calls = count(),
    Failures = countif(Success == false),
    AvgMs = avg(DurationMs),
    P95Ms = percentile(DurationMs, 95)
    by Name, DependencyType
| order by P95Ms desc

Queste query sono punti di partenza: il mapping delle operazioni GenAI in tabelle e proprietà di Application Insights dipende dall'exporter e dalla versione in uso. È quindi necessario verificare che gli span agentici siano realmente esportati in AppDependencies e che i loro attributi siano disponibili in Properties.

Le metriche GenAI consentono inoltre di osservare durata e consumo, ad esempio con nomi come gen_ai.client.operation.duration e gen_ai.client.token.usage quando emessi dalle librerie utilizzate. Le unità di misura non vanno confuse: DurationMs è espresso in millisecondi, mentre le convenzioni GenAI possono esprimere le durate in secondi.

7. Latenza, token e costo economico

Due esecuzioni dello stesso compito possono produrre una risposta comparabile con un consumo di risorse molto diverso.

IndicatoreEsecuzione AEsecuzione B
Chiamate LLM26
Tool eseguiti14
Token totali3.20011.800
Durata2,4 s8,7 s
Confronto dei token utilizzati (scenario illustrativo)
Esecuzione A · 3.200
Esecuzione B · 11.800

La seconda esecuzione utilizza circa 3,7 volte i token della prima. Questo non indica automaticamente un errore: può dipendere dalla complessità del compito. La trace permette però di verificare retry, retrieval ridondanti, contesti eccessivamente ampi e output dei tool poco pertinenti.

Il costo monetario non coincide con i token totali. Una stima credibile distingue token in ingresso e in uscita, modello, eventuale caching, tariffe, strumenti e risorse esterne.

8. Tracing e valutazione della qualità

L'osservabilità tecnica non equivale a una verifica della correttezza dei risultati. Un sistema agentico maturo dovrebbe rispondere a quattro domande complementari.

DimensioneDomanda
TecnicaDove si trova il collo di bottiglia?
EconomicaQuanto costa completare la richiesta?
ComportamentalePerché sono stati utilizzati determinati strumenti?
QualitativaIl risultato è corretto, pertinente e verificabile?

Il tracing è essenziale per ricostruire la traiettoria esecutiva. La valutazione della qualità richiede invece dataset di test, verifiche dei risultati e controlli sull'uso degli strumenti. Il fatto che una risposta sia stata generata senza errori tecnici non dimostra che sia corretta.

9. Sicurezza e privacy della telemetria

Prompt, risposte, argomenti dei tool e documenti possono contenere informazioni personali, riservate o segreti. Le funzionalità che acquisiscono contenuti sensibili, come EnableSensitiveData dove disponibili, non dovrebbero essere abilitate indiscriminatamente in produzione.

  • Redigere o escludere PII, credenziali e dati riservati prima dell'esportazione.
  • Applicare retention e sampling proporzionati alle necessità diagnostiche.
  • Limitare l'accesso ai workspace e alle dashboard.
  • Preferire identificatori tecnici non sensibili per la correlazione.
  • Controllare la cardinalità di tag e dimensioni metriche.

Inserire prompt interi e identificatori ad alta cardinalità nelle metriche può comportare rischi di sicurezza e costi elevati. I contenuti delle conversazioni richiedono un trattamento diverso da normali misure di durata o conteggi.

10. Conclusioni: verso l'osservabilità delle traiettorie agentiche

La principale evoluzione consiste nel passaggio dal monitoraggio di singole chiamate ai modelli all'analisi di traiettorie di esecuzione: la sequenza concreta di inferenze, tool e dipendenze attraversata dall'agente per raggiungere un risultato.

Microsoft Agent Framework fornisce i componenti di orchestrazione; OpenTelemetry introduce un modello interoperabile di tracing, metriche e log; Azure Monitor rende possibile la correlazione e l'analisi in produzione. Per ottenere un sistema affidabile occorre completare questa telemetria con controlli sulla qualità delle risposte e sulle decisioni operative.

Un agente osservabile non è automaticamente affidabile. Un agente non osservabile, però, è molto più difficile da rendere affidabile.

Fonti e documentazione

lunedì 12 ottobre 2026

NicoGIS Tech Weekly — .NET 11 Runtime Async, GeoAI interpretabile, Agent Skills e Decisions API

NicoGIS Tech Weekly  •  12 ottobre 2026  •  Osservatorio tecnico: 5–11 ottobre

Focus di questa edizione
.NET 11: il passaggio dello stato async dal compilatore al runtime e il costo reale delle astrazioni; GeoAI: interpretabilità dei 256 embedding geodemografici con SHAP, più il conflitto fra prossimità geografica e semantica; Experience Builder: Agent Skills come conoscenza architetturale verificabile; LLM: Decisions API e Ultrafast come nuove scelte di orchestrazione.

Una settimana, un problema architetturale: dove finisce la rappresentazione e chi prende la decisione?

Quattro tecnologie apparentemente separate descrivono lo stesso spostamento di responsabilità. In .NET 11, per alcuni metodi async, la trasformazione che gestisce la sospensione si sposta dal compilatore C# al runtime/JIT; nella GeoAI, le migliaia di variabili che descrivono un territorio vengono compresse in uno spazio latente da cui vogliamo però ricavare spiegazioni controllabili; nello sviluppo di Experience Builder, le convenzioni di un framework vengono fornite al coding agent sotto forma di skill; nella nuova Decisions API, un modello non restituisce prosa ma probabilità o scelte tipizzate.

Il tema non è semplicemente migliorare le performance o produrre codice più velocemente. È decidere quali responsabilità possano essere trasferite a un livello intelligente o ottimizzante, quali contratti devono rimanere invarianti e quali verifiche debbano restare sotto il controllo dell’applicazione. In questo numero i fatti documentati sono separati dalle mie analisi: un microbenchmark non diventa uno SLA, SHAP non diventa causalità e la confidenza di un modello non diventa autorizzazione.

Nota sulla selezione. Le notizie realmente nuove della settimana sono il post Microsoft del 6 ottobre su C# Dev Kit, l’articolo Esri del 6 ottobre su AutoML/SHAP e gli annunci OpenAI del 6 e 8 ottobre. Il grande approfondimento di Stephen Toub su .NET 11 (15 settembre) e lo skill Esri (14 settembre) sono ripresi intenzionalmente come fonti tecniche di base: sono troppo importanti per essere liquidati.

01 — .NET 11: Runtime Async cambia il confine compiler/runtime

Dal lowering C# alla generazione JIT della sospensione

Nel lowering tradizionale, Roslyn converte il metodo async in una macchina a stati: tipo generato, MoveNext, campi per gli awaiter e per le variabili ancora vive dopo la sospensione, più il builder del risultato. Il JIT vede già questa rappresentazione trasformata. Il nuovo meccanismo runtime async, descritto da Stephen Toub il 15 settembre 2026, cambia la divisione del lavoro: per i metodi compatibili il compilatore emette IL più compatto, marcato come async, e il runtime/JIT decide come materializzare continuazioni e oggetti Task. Il modello C# pubblico, inclusi await, eccezioni, cancellazione e ConfigureAwait, resta semanticamente invariato.

// Modello concettuale, non una rappresentazione IL letterale.

// Lowering classico
C# async method
    -> compiler-generated state machine
    -> MoveNext + awaiter fields + builder
    -> JIT of already-lowered IL

// Runtime async (.NET 11, opt-in per l'applicazione)
C# async method
    -> compact suspension-aware IL + async metadata
    -> JIT/runtime builds suspend/resume machinery
    -> Task materialized when required by the observable contract

Il dettaglio che merita attenzione è il doppio accesso al metodo: il runtime può gestire un entry point pubblico che restituisce Task<T> e una variante interna AsyncCall capace di passare direttamente T a un chiamante runtime-async che esegue immediatamente await. Nel caso A → await B → await C, i confini intermedi possono essere fusi: se non esiste un consumatore che osservi il Task come oggetto, non è obbligatorio materializzarne uno per ogni livello. Gli adapter preservano interoperabilità con le librerie compilate secondo il modello tradizionale.

// File .csproj: esperimento .NET 11, non feature abilitata
// automaticamente nel codice applicativo.
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net11.0</TargetFramework>
    <Features>$(Features);runtime-async=on</Features>
  </PropertyGroup>
</Project>
FATTO
Nel .NET 11 documentato da Microsoft il meccanismo è opt-in per il codice applicativo, tramite runtime-async=on. La stessa fonte segnala che non tutti i casi sono già ottimizzati e che l’obiettivo iniziale è la compatibilità semantica, non promettere una riduzione universale delle allocazioni. Non confondere quindi “runtime async disponibile” con “runtime async abilitato di default per ogni progetto”.

Quanto vale? Microbenchmark, non capacità produttiva

Nel benchmark di Toub su due livelli async, una catena che completa sincronicamente passa, sulla macchina e con il setup Microsoft, da 21,221 ns e 144 B a 6,151 ns e 0 B; il percorso con un reale Task.Yield() passa da 254,139 ns e 248 B a 116,927 ns e 168 B. In un altro esperimento un assembly con dieci livelli async passa da 10.752 a 5.632 byte. Sono risultati di workload specifici, non coefficienti da applicare a una Web API qualsiasi.

Scenario misurato da MicrosoftLowering classicoRuntime asyncLettura corretta
Catena async, completamento sincrono21,221 ns · 144 B6,151 ns · 0 BBeneficio della mancata materializzazione di task intermedi.
Catena async, sospensione reale254,139 ns · 248 B116,927 ns · 168 BAnche una sospensione può evitare parte del costo delle continuazioni.
Assembly sperimentale, 10 livelli10.752 byte5.632 byteDimensione IL/binary, non tempo di risposta HTTP.

Se un endpoint è dominato da SQL Server, chiamate ArcGIS REST, traffico di rete o latenza cloud, il beneficio globale dell’ottimizzazione di pochi nanosecondi può risultare marginale. Se, invece, il servizio crea milioni di continuazioni brevi — per esempio un middleware che attraversa molti livelli e termina spesso su cache — allora diminuzioni di allocazioni e overhead possono ridurre pressione sul GC e costo CPU. La misura corretta richiede almeno throughput, p95/p99, allocazioni per operazione, pause GC e utilizzo ThreadPool sotto carico reale.

ANALISI
Runtime async è anche un cambiamento di forma del programma. L’ottimizzatore potrà ragionare su liveness e sospensione prima che una state machine esplicita abbia cristallizzato il controllo di flusso. Questo amplia le ottimizzazioni possibili, ma rende ancora più importante disporre di test di compatibilità, tracing dei task e confronti fra runtime quando un’applicazione fa uso di reflection, diagnosi delle stack trace o librerie complesse.

JIT, GC e JSON: la prestazione è una catena di costi

Nello stesso articolo, Microsoft descrive l’escape analysis sui boxing temporanei: in un esempio Nullable<int> che viene formattato attraverso un’interfaccia, il JIT riesce a eliminare un boxing da 24 B perché l’oggetto non esce dal metodo. Per una funzione che restituisce l’oggetto boxed, quell’allocazione resta necessaria. Non è “zero boxing” in senso generale: è una prova sull’observability dell’allocazione.

Sul lato GC, l’espansione di alcune operazioni di store su array espone al JIT i controlli di covarianza e le write barrier, permettendo di eliminarli o semplificarli quando il tipo effettivo è noto. Sulla serializzazione, Utf8JsonWriter usa percorsi basati su SearchValues per identificare i caratteri da sottoporre a escaping; Utf8JsonReader sfrutta IndexOfAnyExcept per saltare sequenze di whitespace. In un microbenchmark altamente favorevole al nuovo percorso, una scrittura JSON scende da 30,83 μs a 7,875 μs: caso utile a capire il meccanismo, non una promessa “JSON 4× più veloce” per ogni payload.

Hot path di un servizio .NET

parse JSON ─► validation ─► async call chain ─► downstream I/O
    │             │               │                 │
SearchValues   JIT/PGO       runtime-async        network/DB
    │             │               │                 │
    └─────────────┴───────────────┴─────────────────┘
                        ↓
              p95 latency + CPU + GC

Un miglioramento locale conta solo rispetto al peso del suo segmento.

Il tema AOT va letto nello stesso modo: Native AOT può eliminare la compilazione JIT dal percorso di avvio e migliorare startup e ingombro operativo di determinati eseguibili; non significa automaticamente che un’app ASP.NET Core con reflection dinamica, plugin o dipendenze non compatibili possa essere pubblicata senza modifiche. Le scelte tra JIT, ReadyToRun e Native AOT richiedono un inventario delle dipendenze e una misura del cold start rispetto allo steady state.

Fonti primarie: Stephen Toub, Performance Improvements in .NET 11 — 15 settembre 2026

Aggiornamento della settimana — C# Dev Kit 11.0, il tooling ridisegnato attorno al tempo di feedback

Il 6 ottobre Microsoft presenta la prerelease di C# Dev Kit 11.0, che succede alla serie 3.3. Qui non stiamo misurando il runtime della nostra applicazione, ma l’infrastruttura che carica soluzioni, produce build incrementali e rende disponibili IntelliSense, test e navigazione del codice. Il cambiamento è concreto: sei processi managed precedenti vengono consolidati in un processo server CSDevKit compilato con Native AOT; la soluzione usa una cache del modello dei progetti, apre per primo il file attivo e carica il resto in modo progressivo.

I dati Microsoft sono rilevanti ma vanno letti con precisione: sulla soluzione Aspire di 407 progetti, active file ready passa fino a 84,1 s → 0,47 s e whole solution ready da 84,1 s → 3,0 s. Nella stessa soluzione una build senza modifiche passa da 34,4 s a 0,88 s, e una con un singolo file C# modificato da 36,1 s a 2,1 s. La memoria dei processi server C# Dev Kit su Aspire scende da 2.072 a 316 MB: Microsoft precisa esplicitamente che questi numeri escludono il processo language service Roslyn e VS Code. La prerelease aggiunge anche supporto semantico ai file MSBuild e il diagnostico C# Doctor.

ANALISI
Questa architettura ha conseguenze importanti per agenti di coding e workspace effimeri: ridurre il costo di ogni nuovo processo, riutilizzare l’analisi dei progetti e rendere rapidamente disponibile il file attivo migliora il feedback loop sia umano sia automatizzato. Attenzione però alla cache versionata: va verificato quali artefatti sono riproducibili, quali sono specifici della macchina e come vengono invalidati, invece di committare indiscriminatamente directory locali nel repository.

Fonti primarie: Microsoft .NET Blog, A faster, lighter C# Dev Kit — 6 ottobre 2026 · Microsoft, Performance Improvements in .NET 11

02 — ArcGIS GeoAI: 256 embedding, quattro segmenti e il rischio di confondere spiegazione con causalità

Il fatto nuovo: AutoML + SHAP con struttura semantica documentata

Il 6 ottobre 2026 Pamir Roy (Esri) pubblica un workflow di interpretabilità per gli USA Geodemographic Embeddings in ArcGIS Pro. Il Geodemographic Foundation Model (GDFM) comprime quattro viste di contesto territoriale in 256 dimensioni, suddivise in quattro segmenti contigui da 64. La documentazione tecnica Esri descrive un multiview autoencoder: ciascuna vista ha un encoder che produce una rappresentazione latente; i vettori vengono concatenati e un’architettura di decoder ricostruisce gli input per guidare l’apprendimento. La layer pubblicata in Living Atlas associa gli embedding a celle Uber H3 di risoluzione 7, con vettori serializzati in campi BLOB e dimensioni disponibili anche come campi numerici.

SegmentoDimensioniVista di origineCosa non è lecito dedurre
S11–64Housing & Household CharacteristicsUna dimensione non equivale a “prezzo abitazione”.
S265–128EnvironmentUna componente non equivale a “temperatura” o “NDVI”.
S3129–192American Community SurveyUn alto SHAP del segmento non dimostra causalità del reddito.
S4193–256Age & Race CensusLa rilevanza predittiva non costituisce giustificazione etica per un uso decisionale.

Le quattro viste non sono indipendenti per costruzione semantica: realtà abitative, ambientali e socioeconomiche si correlano nel mondo reale. Inoltre un autoencoder non conserva i nomi delle variabili come assi interpretabili. Esri mostra l’uso di Train Using AutoML in modalità Basic e dell’output importance table per una previsione della food insecurity basata su dati County Health Rankings 2025; nella tabella vengono riportati i campi VARIABLES e IMPORTANCE. Un embedding come embedding_137 può avere elevata attribuzione nel modello, ma non va rinominato “income” o “employment” soltanto perché appartiene alla terza vista.

La matematica minima necessaria: quale SHAP stiamo sommando?

Esri specifica che IMPORTANCE rappresenta un’media globale del valore assoluto delle attribuzioni SHAP della singola dimensione sul campione di valutazione. La metrica aggregata per una vista viene calcolata sommando quelle importanze delle 64 dimensioni. Se φ(i,j) è la contribuzione firmata della dimensione j sull’osservazione i, si sta quindi leggendo:

S_segmento = somma_j[ (1/N) * somma_i |SHAP(i,j)| ]
              j nel segmento

NON e’ lo stesso oggetto di:

G_segmento = (1/N) * somma_i | somma_j SHAP(i,j) |
                                  j nel segmento

In generale S_segmento >= G_segmento, perche’ le
attribuzioni positive e negative possono compensarsi.

Questa differenza non è un dettaglio: due dimensioni possono avere ciascuna una forte attribuzione assoluta e annullarsi all’interno della stessa osservazione. La somma delle importanze descrive il volume delle attribuzioni individuali, non l’effetto congiunto netto del gruppo e neppure l’ipotetica perdita di accuratezza rimuovendo quel segmento. Per stimare il valore informativo incrementale occorrono esperimenti di ablation (riaddestramento senza una vista) o permutazioni di gruppo, con una validazione coerente con la struttura spaziale dei dati.

FATTO
Nell’esempio pubblicato da Esri il segmento ACS risulta quello con maggiore aggregato di SHAP assoluto per il modello specifico di food insecurity. Esri ribadisce che la graduatoria dipende da task, campione, algoritmo e configurazione: non è una gerarchia universale dei fattori socioeconomici né una conclusione causale.

Una strategia pratica per la produzione consiste nel mantenere separati predictive quality, explainability e robustness: un valore elevato di SHAP racconta come il modello ha sfruttato una rappresentazione, non se la fonte è appropriata, stabile nel tempo o idonea a una decisione amministrativa. Per contesti sensibili, in particolare quando compaiono proxy demografici, è necessario un controllo aggiuntivo di bias, finalità d’uso e possibili differenze di errore fra aree/popolazioni.

Prossimità geografica, prossimità latente e prossimità operativa

La disponibilità della ricerca Find Similar Features Using Embeddings cambia il tipo di domanda che un analista GIS può porre. Due celle H3 distanti centinaia di chilometri possono essere vicine nello spazio dei 256 valori, mentre celle contigue possono differire in condizioni socioeconomiche e ambientali. Esri descrive esplicitamente questa distinzione nei workflow per cercare aree contestualmente simili. Ma per una pianificazione di servizi, “simile” non coincide automaticamente con “raggiungibile”, “vicino” o “ammissibile”.

p = punto/cella di interesse; q = candidato

d_geo(p,q) = distanza geodesica o costo di rete

d_latent(p,q) = distanza nell’embedding
                 (metrica e scaling da validare)

score(p,q) = alpha * normalize(d_geo)
           + beta  * normalize(d_latent)
           + gamma * task_constraints(p,q)

ATTENZIONE: score e pesi sono proposta architetturale,
NON un algoritmo dichiarato da Esri.

Un motore di spatial-semantic retrieval credibile dovrebbe separare almeno tre fasi: (1) filtro spaziale o di rete per eliminare candidati impossibili; (2) ranking nello spazio latente secondo una metrica sperimentata sul dataset e sul tipo di embedding; (3) verifica su attributi espliciti e vincoli di dominio. In alternativa la priorità può essere invertita (prima semantic retrieval, poi validazione GIS), ma la scelta influisce su recall, costi e falsi positivi. Non combinerei direttamente gradi, chilometri, distanza coseno e indicatori socioeconomici senza normalizzazione e calibrazione.

Il secondo errore sistematico è il leakage spaziale. Uno split casuale del dataset può mettere nelle partizioni di training e test celle contigue e fortemente autocorrelate, ottenendo metriche eccessivamente ottimistiche. La letteratura scientifica sulle strategie di cross-validation per dati spaziali documenta il problema. Per un esperimento credibile bisogna confrontare holdout casuale e holdout per blocchi geografici, idealmente valutando anche l’effetto della dimensione del buffer rispetto alla correlazione residua. Non è un’impostazione di SHAP: è una proprietà del disegno sperimentale.

VALUTAZIONE
Gli embedding aprono una ricerca “per analogia territoriale”, ma l’analogia dipende dal modello e dalla finestra temporale dei dati che lo hanno addestrato. La documentazione GDFM riporta viste con anni di riferimento differenti (Census, ACS, dataset ambientali): usare questi vettori per una decisione corrente senza verificare l’aggiornamento delle sorgenti può trasformare un raffinato similarity search in una mappa di contesti storici.

Fonti primarie: Esri, Interpret embeddings using AutoML and SHAP — 6 ottobre 2026 · Esri, Concepts of USA Geodemographic Embeddings · Esri, Introducing USA Geodemographic Embeddings — 9 luglio 2026 · Lundberg & Lee, paper SHAP originale (NeurIPS 2017) · Roberts et al., spatial cross-validation (Ecography 2017)

03 — Experience Builder Agent Skills: il framework diventa conoscenza caricabile, ma la CI resta il giudice

La skill Esri non è un generatore magico di widget

Il 14 settembre Esri ha distribuito come open source arcgis-exb-widget-dev nel repository ufficiale delle risorse SDK di Experience Builder. Lo skill codifica struttura del progetto, convenzioni delle directory di Developer Edition, separazione fra pannello di settings e runtime, interazione con map/data source, state management, accessibility, theming, compatibilità delle configurazioni e riferimenti specifici richiamabili in modo selettivo dall’agente. Per Codex il post Esri suggerisce la cartella .agents/skills/; gli altri agent usano directory proprie. Non c’è un nuovo runtime Esri coinvolto: è contesto procedurale per un coding agent, non un’API eseguibile dal browser.

Developer Edition (esempio concettuale)
client/
  your-extensions/
    widgets/
      my-widget/
        manifest.json
        config.json
        src/   <-- runtime / setting / config, secondo template

.agents/skills/
  arcgis-exb-widget-dev/
    SKILL.md
    references/
    assets/

source code + framework skill + tests/CI
          -> 
      validazione

Esri specifica che i widget custom devono utilizzare le astrazioni di Experience Builder: in settings DataSourceSelector e altri selector di framework, con persistenza di useDataSources nell’appConfig; a runtime DataSourceComponent e, quando serve una mappa, JimuMapViewComponent. Questi contratti sono più importanti della generazione di uno scaffold che “compila”: gestiscono il lifecycle del builder, la selezione dei campi, le dipendenze da altri widget e l’interoperabilità dell’applicazione.

La frattura architetturale concreta: 2027 e web components

Esri ha comunicato che i custom widget Experience Builder dipendenti dai widget del Maps SDK for JavaScript dovranno migrare verso i web components del Maps SDK prima di adottare le release Experience Builder previste da Q1 2027 in poi che li sostituiscono. La stessa comunicazione distingue il momento in cui l’applicazione smette di funzionare: è legato all’upgrade della versione utilizzata, non al semplice scoccare della data di calendario. Non significa che ogni custom widget sarà automaticamente incompatibile: riguarda quelli che utilizzano i vecchi widget JS SDK.

Questa transizione rende particolarmente pericoloso un coding agent addestrato su esempi eterogenei: può generare codice sintatticamente coerente ma vincolato a componenti destinati alla rimozione. Lo skill vendor dovrebbe quindi essere version-aware e l’applicazione dovrebbe avere una matrice di versioni realmente testate. Il repository Esri include anche cartelle di patch specifiche per release: una convenzione attuale non è automaticamente compatibile con qualunque ArcGIS Enterprise installato.

Controlli proposti per una pull request di widget

[1] Versione Experience Builder esplicita
[2] Framework API e web components compatibili
[3] No API obsolete di Maps SDK widgets
[4] Settings/runtime separation preservata
[5] appConfig aggiornabile senza perdita di dati
[6] Lifecycle Map / DataSource gestito
[7] Keyboard, ARIA, tema e responsive layout
[8] Test di build, lint e smoke test UI
[9] Nessun segreto o token hardcoded nel client

Questa checklist e’ una proposta editoriale,
non uno script CI ufficiale Esri.
ANALISI
Tre livelli da tenere distinti. (1) Vendor skill: conoscenza del framework e delle versioni. (2) Repository skill: invarianti del progetto, convenzioni locali, procedure di packaging e release. (3) Validation gate: compilazione, test automatici, regression e review. Il terzo è indispensabile: i file di istruzioni aumentano la probabilità di codice corretto, ma non provano che il codice generato sia corretto. Inoltre lo skill è un input potenzialmente non attendibile nella supply chain dell’agente: va revisionato e versionato come qualunque dipendenza che può influenzare modifiche al repository.

Fonti primarie: Esri, Building Custom Experience Builder Widgets with an Agent Skill — 14 settembre 2026 · Repository GitHub ufficiale, SDK Resources e skill · Esri Developer, concetti dei widget · Esri Developer, Use data source in widget · Esri, retirement dei widget JS SDK — 8 aprile 2026

04 — LLM architecture: Decisions API e Ultrafast dividono il reasoning dal decision plane

6 ottobre: una API tipizzata per scegliere, non per “rispondere in JSON”

Il 6 ottobre 2026 OpenAI ha introdotto in beta pubblica la Decisions API con il modello gpt-6-luna e l’endpoint POST /v1/decisions. La superficie è deliberatamente più stretta della Responses API: riceve input testuale o immagini e valuta domande dichiarate dall’applicazione, restituendo predicate (probabilità booleana), choice (una delle alternative date) o score (punteggio su livelli ordinati). OpenAI dichiara una velocità “circa 10×” rispetto alla Responses API per questo tipo di task: è un claim del vendor su una classe di operazioni, non un benchmark indipendente su qualsiasi prompt o ambiente. Il modello attualmente previsto dalla documentazione per questa API è solo gpt-6-luna.

Il prezzo pubblicato per /v1/decisions con Luna è 0,10 USD per milione di token di input, senza addebito di token in output né letture/scritture della cache per questa specifica API. Sono previste maggiorazioni regionali e per contesti lunghi. Per testi, dati o immagini regolamentati, il supporto a ZDR, HIPAA e residenza geografica dipende dall’idoneità dell’organizzazione e dai relativi accordi: non equivale a una certificazione automatica di conformità del progetto.

La distinzione di prodotto è cruciale: se serve estrarre un oggetto arbitrario conforme a schema JSON, la documentazione rimanda agli Structured Outputs nella Responses API; se serve eseguire strumenti, usa function calling. La Decisions API, invece, formalizza un output decisionale ristretto. Questo può semplificare i confini fra classifier, policy engine e orchestratore, ma non li deve fondere.

INPUT: "Errore 500 al servizio di mappe pioggia"
            |
            v
     Decisions API (beta)
       type=choice
   gis | infrastructure | other
            |
            v
   probabilita’ + confidence
            |
            v
   Threshold + policy + audit
         /          \
        v            v
 Escalation      Workflow
   umana         autorizzato
            |
            v
       Strumenti reali
       (token limitati)

La decisione del modello NON autorizza strumenti.

Richiesta riproducibile, senza inventare SDK .NET non documentati

L’esempio seguente usa semplicemente la normale HttpClient di .NET, l’endpoint REST pubblicato e System.Net.Http.Json. È una demo di routing e non una autorizzazione ad aprire ticket o mutare dati GIS. Il valore 0.90 è una soglia illustrativa da sostituire con una soglia scelta e calibrata su un dataset reale; nessuna probabilità del modello va considerata automaticamente calibrata.

// Console .NET 10/11: OPENAI_API_KEY nell’ambiente.
using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Json;

var key = Environment.GetEnvironmentVariable("OPENAI_API_KEY")
    ?? throw new InvalidOperationException("Missing OPENAI_API_KEY");

using var http = new HttpClient {
    BaseAddress = new Uri("https://api.openai.com/")
};
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", key);

var request = new {
    model = "gpt-6-luna",
    input = "The rain map service returns HTTP 500",
    questions = new[] { new {
        type = "choice",
        name = "triage",
        instructions = "Which team should investigate this issue?",
        choices = new[] {
            new { value = "gis", description = "Map, GIS or spatial service" },
            new { value = "infra", description = "Host, network, certificate" },
            new { value = "other", description = "Ambiguous or unrelated" }
        }
    }}
};

using var response = await http.PostAsJsonAsync("v1/decisions", request);
response.EnsureSuccessStatusCode();
using var body = await JsonDocument.ParseAsync(
    await response.Content.ReadAsStreamAsync());
var answer = body.RootElement.GetProperty("answers")[0];

if (answer.GetProperty("type").GetString() != "choice") {
    Console.WriteLine("Review required: no choice answer");
    return;
}
var team = answer.GetProperty("choice").GetString();
var confidence = answer.GetProperty("confidence").GetDouble();

// Demo only: calibrare su ground truth e costo degli errori.
Console.WriteLine(confidence >= 0.90 && team != "other"
    ? $"Proposed triage: {team} (review/policy still required)"
    : "Human review required");

La risposta alle domande choice include sia una distribuzione di probabilità sulle categorie sia un campo confidence; per predicate viene fornita una stima della probabilità della condizione. Non vanno confusi: sono grandezze emesse dall’API, non la garanzia che su 100 casi con score 0,9 se ne azzecchino esattamente 90. Servono dati etichettati, curva di calibrazione, matrice di confusione, costi asimmetrici di falsi positivi e negativi e un percorso per i rifiuti o i casi other. Per una scelta binaria con probabilità calibrata p, il classico cutoff derivato dai costi C_FP/(C_FP+C_FN) è significativo solo dopo avere esplicitato le ipotesi su perdite e distribuzione delle classi.

8 ottobre: GPT-6.1 Sol Ultrafast e la latenza di orchestrazione

L’8 ottobre il changelog OpenAI registra il supporto Ultrafast per gpt-6.1-sol nella Responses API. La configurazione è service_tier: "ultrafast"; il servizio dichiara rate limit separati e supporto alla residenza dati negli Stati Uniti e nell’area EU per Sol, secondo i requisiti applicabili. La guida raccomanda connessioni WebSocket persistenti, soprattutto per applicazioni agentiche con molte chiamate consecutive a tool: senza riuso della connessione il costo di rete può erodere il beneficio della velocità di generazione.

// Corpo JSON minimale documentato per Responses API
{
  "model": "gpt-6.1-sol",
  "service_tier": "ultrafast",
  "input": "Produce a concise incident summary."
}

// Performance engineering: non misurare solo tokens/sec.
T_task = T_network + T_inference + T_tools + T_retries
       + T_validation + T_commit

C_success = (C_model + C_tools + C_retries + C_ops)
          / P(task completed correctly)

Formule architetturali illustrative, non metriche vendor.

Per un agente che fa dieci chiamate sequenziali, il tempo totale non coincide con il tempo della singola generazione. Bisogna isolare TTFT (time to first token), intervalli fra token, p95 end-to-end, latenza delle chiamate a strumenti e tempi di validazione, controllando differenze fra processing tier e region. Ultrafast ha un costo più elevato documentato dal vendor: la decisione economica va presa sul costo per task corretto entro SLA, non sul miglior risultato isolato di streaming.

Un altro aggiornamento, del 7 ottobre, modifica il puntatore chat-latest verso lo snapshot più recente di ChatGPT. Per una pipeline riproducibile questo è un promemoria: un alias mobile facilita la sperimentazione ma non è una promessa di immutabilità delle risposte. Per test e produzione conviene registrare almeno model ID effettivo, versione del prompt, parametri, dataset eval e data dell’esperimento.

VISIONE
Si sta formando una separazione architetturale interessante: decision service economico e tipizzato per classificazioni ad alto volume, reasoning/orchestrator per task non deterministici complessi, policy engine deterministico per autorizzazione e invarianti. Non tutto ciò che chiamiamo “agente” ha bisogno di un orchestratore generale; in alcuni workflow la scelta migliore è una decisione probabilistica circoscritta seguita da un comando tradizionale verificabile.

Fonti primarie: OpenAI API Changelog — 6, 7 e 8 ottobre 2026 · OpenAI, Decisions API (beta), schema e pricing · OpenAI, Ultrafast mode, configurazione e limiti

05 — Sintesi architetturale: AI nel control plane, invarianti nel dominio

Il collegamento fra le quattro notizie è più concreto di una narrativa sull’intelligenza artificiale. Il runtime async elimina oggetti quando dimostra che il programma non li può osservare; SHAP offre una spiegazione sulla rappresentazione sfruttata dal modello, ma non sostituisce la verifica causale o spaziale; gli Agent Skills aumentano la probabilità di una corretta implementazione, ma non sostituiscono compilazione e regression; una API di decisione tipizzata produce una proposta probabilistica, ma non ha alcuna autorità sul dominio.

OSSERVAZIONI + DATI
                       |
       [normalizzazione e provenienza]
                       |
                  EMBEDDING
                       |
         [modello, versione, drift]
                       |
                INFERENZA / SHAP
                       |
               DECISION PROPOSAL
                       |
       [policy, permission, validation]
                       |
                 DOMAIN COMMAND
                       |
             AUTHORITATIVE STATE
                       |
           [audit, rollback, metrics]

Separazione architetturale proposta, non diagramma vendor.

Per un’app GIS enterprise potremmo tradurre questo schema in un servizio .NET che acquisisce dati da ArcGIS, calcola o recupera descrittori contestuali, usa un classificatore tipizzato per suggerire una categoria, impone policy e controllo dell’utente per le operazioni mutative e infine registra un comando validato. La UI, realizzata con Experience Builder o Blazor, visualizza stato e proposta ma non diventa l’autorità sulle modifiche. La tracciabilità minima include input data version, modello, prompt, score, utente approvatore, comando e risultato operativo.

VALUTAZIONE
Questo disegno evita due estremi: trattare la GenAI come un semplice widget di chat decorativo e, all’opposto, concederle accesso diretto a qualsiasi funzione applicativa. Il guadagno principale può essere una migliore divisione dei compiti: probabilistico dove serve inferire, deterministico dove serve garantire.

Technical Takeaways

  • .NET 11 runtime async: il confine fra metodi async e oggetti Task diventa più ottimizzabile; applicazioni ancora opt-in, beneficio da misurare su allocazioni e latenza reali, non solo sui nanosecondi di un esempio.
  • C# Dev Kit 11.0: Native AOT, meno processi e cache dei progetti sono scelte architetturali che accorciano il feedback loop; i benchmark Microsoft si riferiscono al server Dev Kit, non alla memoria totale dell’IDE.
  • GeoAI e SHAP: l’interpretabilità dei quattro segmenti è un buon punto di partenza, non una decomposizione causale. La domanda successiva è sempre: quanto regge su territori e tempi mai visti?
  • Experience Builder: uno skill formalizza convenzioni e conoscenza tecnica; release matrix, test, web components e review continuano a definire la compatibilità effettiva.
  • LLM systems: Decisions API e Ultrafast suggeriscono di selezionare la superficie API per il lavoro richiesto. Confidence, latenza e costo hanno senso soltanto rispetto a qualità, policy, SLA e dataset di valutazione.

Lab della settimana

Lab 1 — Runtime async: lo stesso workload, due lowering, risultati falsificabili

Setup: installare .NET 10 e una RC di .NET 11, creare un progetto di benchmark, eseguire in Release sullo stesso computer senza cambiare governor/affinità o condizioni di carico. Usare l’esperimento pubblicato da Toub con metodi RuntimeAsyncMethodGeneration(false) e le varianti runtime-async in un progetto con <Features>$(Features);runtime-async=on</Features>. Misurare metodo senza sospensione e con Task.Yield(); registrare runtime build, architettura CPU, throughput, media, deviazione e allocazioni. Poi ripetere su una catena applicativa reale: qui il risultato può essere nullo, positivo o regressivo. Documentazione e codice completo: Stephen Toub, sezione Runtime Async.

Lab 2 — SHAP a segmenti: importanza globale contro ablation e spatial holdout

Setup: in ArcGIS Pro usare la layer USA Geodemographic Embeddings di Living Atlas, una variabile target appropriata e Train Using AutoML in Basic Mode con Output Importance Table. Raggruppare i record embedding_1..256 in quattro intervalli di 64, sommare IMPORTANCE e normalizzare la quota di ogni gruppo. Addestrare un secondo modello senza il segmento dominante; confrontare il decadimento della metrica su validazione casuale e per blocchi spaziali. Non attribuire il decadimento esclusivamente a causalità: la prova valuta il valore predittivo incrementale nel disegno scelto. Fonti: workflow Esri del 6 ottobre, modello e dataset, fondamento scientifico dello spatial holdout.

Lab 3 — Experience Builder skill A/B: dalle istruzioni al contratto verificato

Setup: clonare le risorse SDK ufficiali Esri, predisporre una Developer Edition esplicitamente versionata e chiedere al medesimo coding agent di realizzare un widget che legge una FeatureLayer, risponde alla selezione della mappa e mantiene compatibile la configurazione. Eseguire tre run con prompt identico: senza skill, skill Esri, skill Esri + regole locali (solo se tali regole sono state effettivamente create). Per ogni run misurare build/test passati, riferimenti ad API obsolete, errori di runtime, accessibilità, correzioni umane, tool calls e tempo al widget funzionante. Includere test su almeno due versioni supportate se disponibili. Fonti: repository SDK/skill, contratti DataSource, migrazione 2027.

Micro-esperimento extra, già incorporato nella sezione LLM: eseguire il client HttpClient della Decisions API su un set di incident già etichettati. Confrontare accuracy, false-route rate e coverage rispetto a un router deterministico; solo in un secondo momento valutare latenza e prezzo. Documentazione: Decisions API.


NicoGIS Tech Weekly · edizione del 12 ottobre 2026. Analisi indipendente e non promozionale. Nessun benchmark dell’autore viene spacciato per misurazione svolta: i numeri citati sono quelli delle fonti primarie, con ambito e limiti esplicitati. “Analisi”, “Valutazione” e “Visione” identificano inferenze o proposte progettuali, non comunicazioni ufficiali dei vendor.

venerdì 9 ottobre 2026

Agentic Planning vs Deterministic Execution: architetture AI affidabili con Azure Durable Functions, DAG e GeoAgent

Quando l'intelligenza pianifica, ma non controlla l'esecuzione

Per molto tempo abbiamo progettato gli agenti AI secondo un modello relativamente semplice: un Large Language Model interpreta una richiesta, seleziona uno strumento, ne osserva il risultato e decide cosa fare successivamente.

Il modello funziona bene per task brevi. Diventa però progressivamente meno efficiente quando deve coordinare decine di strumenti, elaborare grandi volumi di dati, gestire retry, attendere eventi esterni e garantire che operazioni già completate non vengano ripetute accidentalmente.

Con Dynamic Workflows for Azure Functions Hosted Skills, annunciato da Microsoft l'8 ottobre 2026, emerge un'architettura differente: l'LLM genera un piano strutturato, mentre un runtime durevole e deterministico si occupa della sua esecuzione.

La distinzione è fondamentale. Il modello non diventa improvvisamente affidabile perché produce JSON anziché testo. È il sistema che interpreta quel JSON a dover imporre vincoli, autorizzazioni, dipendenze e garanzie operative.

Principio architetturale: un LLM può proporre una sequenza di azioni, ma non dovrebbe essere l'autorità finale che decide se quelle azioni sono consentite, sicure o già state eseguite.

1. Il problema del reasoning loop tradizionale

Consideriamo un agente che deve analizzare un evento meteorologico, interrogare servizi GIS, produrre una mappa di rischio e inviare una notifica.

User / Event
    |
    v
   LLM
    |
    +-- Tool: read rainfall
    |       |
    |       v
    |      LLM
    |
    +-- Tool: read terrain
    |       |
    |       v
    |      LLM
    |
    +-- Tool: run spatial analysis
    |       |
    |       v
    |      LLM
    |
    +-- Tool: generate map
    |       |
    |       v
    |      LLM
    |
    +-- Tool: publish result
            |
            v
           LLM

Ogni operazione comporta un nuovo passaggio attraverso il modello. Se gli strumenti restituiscono dati voluminosi, il contesto si riempie di risultati intermedi che il modello potrebbe non aver bisogno di interpretare direttamente.

Il problema non è soltanto economico. È anche architetturale:

  • Latenza: le chiamate al modello possono serializzare operazioni indipendenti.
  • Context pollution: risultati intermedi e log possono occupare una parte significativa della context window.
  • Recovery: un crash durante un'operazione lunga richiede meccanismi di ripresa espliciti.
  • Retry: ripetere un tool può duplicare effetti esterni.
  • Audit: ricostruire perché un'azione sia stata eseguita può diventare difficile.
  • Security: il contenuto restituito da un tool può influenzare impropriamente le decisioni successive dell'agente.

Un reasoning loop è appropriato quando ogni risultato richiede una nuova decisione semantica. Non è necessariamente la scelta migliore quando le operazioni sono note, verificabili e largamente indipendenti.

2. L'architettura emergente: Plan, Validate, Execute, Verify

La nuova separazione delle responsabilità può essere rappresentata così:

                 USER / EVENT
                      |
                      v
              +---------------+
              |  LLM PLANNER  |
              +---------------+
                      |
                 Proposed DAG
                      |
                      v
              +---------------+
              | DAG VALIDATOR |
              | Policy Engine |
              +---------------+
                      |
                Approved Plan
                      |
                      v
              +---------------+
              | DURABLE ENGINE|
              +---------------+
                /     |     \
               v      v      v
           Tool A   Tool B   Tool C
               \      |      /
                \     |     /
                 v    v    v
                AGGREGATION
                      |
                      v
                VERIFICATION
                      |
                      v
                FINAL RESULT

Il passaggio più importante è quello fra planner e runtime.

Il piano generato dal modello deve essere considerato un input non attendibile, anche quando il modello appartiene a un provider affidabile. La validazione non può essere una semplice verifica della sintassi JSON: deve includere controlli strutturali, semantici, autorizzativi e di consumo delle risorse.

Microsoft applica questo paradigma nella preview Dynamic Workflows di Azure Functions Hosted Skills. Il runtime utilizza Durable Functions per eseguire il piano senza riportare continuamente i risultati intermedi nel reasoning loop dell'LLM.

È importante distinguere la funzionalità specifica Microsoft, attualmente in preview e basata su tool Python, da un'implementazione equivalente realizzata autonomamente in C# e .NET con Durable Functions.

3. Il DAG come contratto eseguibile

Un Directed Acyclic Graph è un grafo diretto senza cicli. Ogni nodo rappresenta un'operazione; ogni arco rappresenta una dipendenza.

Consideriamo un piano per valutare il rischio associato a precipitazioni intense:

         ReadRainfall
              |
              +----------------+
              |                |
              v                v
        LoadTerrain      LoadAssets
              |                |
              v                |
        ComputeRunoff          |
              |                |
              +--------+-------+
                       |
                       v
                IntersectRisk
                       |
                       v
                 GenerateMap
                       |
                       v
                PublishResult

Il DAG esplicita immediatamente il parallelismo possibile: LoadTerrain e LoadAssets possono partire quando ReadRainfall è completato, se le rispettive operazioni non dipendono l'una dall'altra.

In un sistema reale conviene spingersi oltre, rendendo indipendenti tutte le acquisizioni che non richiedono il risultato delle precipitazioni.

Un contratto JSON minimale

{
  "schemaVersion": "1.0",
  "workflowId": "rainfall-risk-20261009",
  "nodes": [
    {
      "id": "rainfall",
      "tool": "gis.readRainfall",
      "dependsOn": []
    },
    {
      "id": "terrain",
      "tool": "gis.loadTerrain",
      "dependsOn": []
    },
    {
      "id": "assets",
      "tool": "gis.loadAssets",
      "dependsOn": []
    },
    {
      "id": "risk",
      "tool": "gis.computeRisk",
      "dependsOn": [
        "rainfall",
        "terrain",
        "assets"
      ]
    },
    {
      "id": "map",
      "tool": "gis.generateMap",
      "dependsOn": ["risk"]
    }
  ]
}

Questo JSON è una rappresentazione concettuale del nostro contratto applicativo, non lo schema ufficiale della preview Microsoft.

Un contratto production-grade dovrebbe inoltre includere versione del piano, input tipizzati, riferimenti agli output, classificazione dei tool, limiti di esecuzione e policy di autorizzazione. Gli argomenti non devono poter contenere endpoint arbitrari o istruzioni eseguibili non previste.

4. DAG validation: il vero confine di sicurezza

La validazione di un piano prodotto da un LLM deve essere eseguita prima che il workflow venga avviato.

I controlli minimi comprendono:

  • Identificatori univoci dei nodi.
  • Assenza di dipendenze inesistenti.
  • Assenza di cicli.
  • Limiti su numero di nodi, profondità e fan-out.
  • Tool presenti in una allowlist server-side.
  • Compatibilità tra input e output dei tool.
  • Autorizzazioni coerenti con utente, tenant e risorsa.
  • Limiti su costo, durata e concorrenza.
  • Approvazioni esplicite per operazioni con effetti esterni sensibili.

Validazione strutturale in C#

public sealed record WorkflowNode(
    string Id,
    string Tool,
    string[] DependsOn);

public sealed record WorkflowPlan(
    string SchemaVersion,
    WorkflowNode[] Nodes);

public static class DagValidator
{
    private static readonly HashSet<string> AllowedTools =
        new(StringComparer.Ordinal)
        {
            "gis.readRainfall",
            "gis.loadTerrain",
            "gis.loadAssets",
            "gis.computeRisk",
            "gis.generateMap"
        };

    public static void Validate(WorkflowPlan plan)
    {
        ArgumentNullException.ThrowIfNull(plan);

        if (plan.SchemaVersion != "1.0")
            throw new InvalidOperationException(
                "Unsupported schema version.");

        if (plan.Nodes is null ||
            plan.Nodes.Length is < 1 or > 50)
            throw new InvalidOperationException(
                "Invalid workflow size.");

        var nodes = new Dictionary<string, WorkflowNode>(
            StringComparer.Ordinal);

        foreach (var node in plan.Nodes)
        {
            if (string.IsNullOrWhiteSpace(node.Id) ||
                !nodes.TryAdd(node.Id, node))
                throw new InvalidOperationException(
                    "Invalid or duplicate node ID.");

            if (!AllowedTools.Contains(node.Tool))
                throw new InvalidOperationException(
                    $"Tool not allowed: {node.Tool}");
        }

        var indegree = nodes.Keys.ToDictionary(
            id => id,
            _ => 0,
            StringComparer.Ordinal);

        var children = nodes.Keys.ToDictionary(
            id => id,
            _ => new List<string>(),
            StringComparer.Ordinal);

        foreach (var node in nodes.Values)
        {
            var dependencies = node.DependsOn ??
                throw new InvalidOperationException(
                    "Dependencies cannot be null.");

            foreach (var dependency in dependencies.Distinct())
            {
                if (!nodes.ContainsKey(dependency))
                    throw new InvalidOperationException(
                        $"Unknown dependency: {dependency}");

                indegree[node.Id]++;
                children[dependency].Add(node.Id);
            }
        }

        var ready = new Queue<string>(
            indegree
                .Where(x => x.Value == 0)
                .Select(x => x.Key));

        var visited = 0;

        while (ready.Count > 0)
        {
            var id = ready.Dequeue();
            visited++;

            foreach (var child in children[id])
            {
                if (--indegree[child] == 0)
                    ready.Enqueue(child);
            }
        }

        if (visited != nodes.Count)
            throw new InvalidOperationException(
                "Workflow contains a cycle.");
    }
}

L'algoritmo utilizza una variante del topological sorting di Kahn. La complessità è O(V + E), dove V rappresenta i nodi ed E le dipendenze.

Questo codice valida soltanto la struttura e una allowlist di base. Non rappresenta un security validator completo. In produzione servono anche controllo degli argomenti, autorizzazione contestuale, compatibilità dei tipi, quote e validazione della provenienza del piano.

Un ulteriore accorgimento consiste nel calcolare un hash canonico del piano validato, registrando insieme ad esso identità del richiedente, versione delle policy e identificativo dell'esecuzione. Il runtime dovrebbe eseguire esattamente quel piano immutabile, evitando modifiche successive alla validazione.

5. Durable Functions: perché l'orchestrazione deve essere deterministica

Azure Durable Functions utilizza una forma di event sourcing per ricostruire lo stato delle orchestrazioni.

Quando un'orchestrazione riprende dopo un evento, il runtime può rieseguire il codice dell'orchestratore dall'inizio, recuperando dalla history i risultati delle attività già completate.

Questo meccanismo prende il nome di replay.

Execution history
       |
       +-- ActivityScheduled(A)
       +-- ActivityCompleted(A)
       +-- ActivityScheduled(B)
       +-- ActivityCompleted(B)
       |
       v
  Orchestrator Replay
       |
       +-- A: result from history
       +-- B: result from history
       +-- C: schedule new activity

Il codice dell'orchestratore deve quindi essere deterministico. Non dovrebbe effettuare direttamente chiamate HTTP, interrogazioni SQL, operazioni GIS o letture dell'orologio di sistema.

Le operazioni con effetti esterni appartengono alle Activity Functions.

Esempio di orchestrazione C# con .NET isolated worker

using Microsoft.Azure.Functions.Worker;
using Microsoft.DurableTask;

public static class GeoWorkflow
{
    [Function(nameof(RunGeoWorkflow))]
    public static async Task<string> RunGeoWorkflow(
        [OrchestrationTrigger]
        TaskOrchestrationContext context)
    {
        var rainfallTask =
            context.CallActivityAsync<string>(
                "ReadRainfall");

        var terrainTask =
            context.CallActivityAsync<string>(
                "LoadTerrain");

        var assetsTask =
            context.CallActivityAsync<string>(
                "LoadAssets");

        await Task.WhenAll(
            rainfallTask,
            terrainTask,
            assetsTask);

        var input = new RiskInput(
            rainfallTask.Result,
            terrainTask.Result,
            assetsTask.Result);

        var risk =
            await context.CallActivityAsync<string>(
                "ComputeRisk",
                input);

        return await context.CallActivityAsync<string>(
            "GenerateMap",
            risk);
    }
}

public sealed record RiskInput(
    string RainfallUri,
    string TerrainUri,
    string AssetsUri);

Questo è un esempio di orchestrazione statica. Non è ancora un interprete dinamico di DAG: serve a mostrare il modello Durable Functions e il parallelismo fan-out/fan-in.

Le tre Activity iniziali restituiscono riferimenti a dati persistenti, non interi raster o dataset serializzati nella history dell'orchestrazione.

Per interpretare DAG generati dinamicamente è preferibile utilizzare un executor generico che riceva un piano validato, identifichi i nodi pronti e li programmi attraverso un catalogo di Activity consentite.

6. Un DAG executor dinamico: la differenza fra scheduling e reasoning

Il runtime non deve chiedere all'LLM quale nodo eseguire dopo ogni completamento. Deve applicare una regola deterministica:

Ready(node) =
    AllDependenciesCompleted(node)
    AND PolicyAllows(node)
    AND ResourcesAvailable(node)

Un possibile algoritmo è:

completed = {}
pending = allNodes

while pending is not empty:

    ready = nodes where:
        every dependency is completed

    if ready is empty:
        fail invalid workflow

    execute ready nodes concurrently
    await completion

    persist outputs
    mark nodes completed
    remove nodes from pending

Questo pseudocodice illustra l'idea, ma in produzione richiede alcuni raffinamenti importanti.

Prima di tutto, i nodi devono essere ordinati stabilmente per evitare divergenze durante il replay. Inoltre la concorrenza deve essere limitata, gli errori devono essere gestiti per nodo e il risultato di ogni Activity deve essere registrato con un identificatore stabile.

Un semplice Task.WhenAll() su tutti i nodi pronti può produrre fan-out eccessivo. In un workflow geografico, cinquanta richieste simultanee a un servizio ArcGIS possono saturare il servizio, esaurire risorse o produrre throttling.

È quindi utile distinguere tre livelli di concorrenza:

  • Workflow concurrency: quante orchestrazioni possono essere attive.
  • Node concurrency: quanti nodi dello stesso DAG possono essere eseguiti contemporaneamente.
  • Resource concurrency: quante operazioni possono utilizzare uno specifico servizio, database o pool di worker.

Il terzo livello è particolarmente importante: limitare il fan-out di una singola orchestrazione non impedisce a cento orchestrazioni concorrenti di sovraccaricare lo stesso servizio.

7. Idempotenza: at-least-once non significa exactly-once

Uno dei problemi più pericolosi dei workflow distribuiti è la ripetizione delle operazioni.

Durable Functions può rieseguire un'Activity quando si verifica un errore o quando il completamento dell'attività non è stato registrato correttamente.

Supponiamo che un'Activity esegua:

POST /arcgis/rest/services/Analysis/GPServer/SubmitJob

Il servizio remoto riceve la richiesta e avvia il job. Subito dopo, il worker Azure Functions si interrompe prima di registrare il risultato.

Al riavvio, il runtime può ripetere l'Activity.

Il risultato potrebbe essere:

First attempt  --> ArcGIS Job 1001
Worker crash
Second attempt --> ArcGIS Job 1002

Il sistema ha prodotto due elaborazioni per una sola richiesta logica.

Il retry è quindi corretto dal punto di vista dell'infrastruttura, ma non necessariamente dal punto di vista del business.

La soluzione: Operation Ledger e Idempotency Key

Ogni operazione con effetti esterni dovrebbe avere una chiave stabile:

IdempotencyKey =
    WorkflowId + ":" + NodeId

Una tabella SQL può mantenere lo stato dell'operazione:

CREATE TABLE WorkflowOperations
(
    OperationKey NVARCHAR(200) NOT NULL
        PRIMARY KEY,

    State NVARCHAR(30) NOT NULL,

    ExternalJobId NVARCHAR(200) NULL,

    ResultUri NVARCHAR(2000) NULL,

    UpdatedAt DATETIMEOFFSET NOT NULL
);

Il pattern operativo diventa:

1. Reserve OperationKey atomically
2. Check previous execution state
3. Submit or reconcile external job
4. Persist ExternalJobId
5. Poll external job
6. Persist ResultUri
7. Mark operation Completed

È fondamentale riconoscere che il ledger, da solo, non garantisce exactly-once.

Esiste infatti una finestra critica fra l'invio della richiesta al sistema esterno e il salvataggio dell'ExternalJobId. Se il processo si interrompe in quel punto, il database locale non sa se l'operazione remota sia stata accettata.

Per eliminare questa ambiguità serve un meccanismo di riconciliazione: una chiave di idempotenza supportata dal servizio remoto, un identificatore applicativo ricercabile oppure un adapter che possa individuare un job già creato.

Se l'API esterna non supporta alcuna forma di deduplicazione o riconciliazione, la garanzia di exactly-once non può essere ottenuta semplicemente aggiungendo retry e una tabella SQL.

8. Retry, timeout, circuit breaker e compensazione

Un workflow distribuito affidabile deve distinguere gli errori transitori da quelli permanenti.

Un HTTP 429 o 503 può giustificare un retry con backoff. Un errore di autorizzazione, un input GIS non valido o un piano che viola una policy non dovrebbe invece essere ripetuto automaticamente.

Per gli errori transitori è possibile utilizzare le retry policy delle Activity Durable Functions.

Per operazioni che modificano sistemi esterni è inoltre utile introdurre una logica di compensazione.

Consideriamo:

CreateAnalysisJob
        |
        v
PublishFeatureLayer
        |
        v
UpdateWebMap
        |
        v
NotifyUsers

Se UpdateWebMap fallisce dopo la pubblicazione del layer, il sistema potrebbe dover eliminare il layer temporaneo o ripristinare la configurazione precedente.

Questo modello è vicino al pattern Saga: ogni azione può avere un'azione compensativa, ma la compensazione non equivale necessariamente a un rollback transazionale perfetto.

Per un workflow geografico occorre inoltre distinguere:

  • Risultati temporanei, eliminabili automaticamente.
  • Risultati pubblicati, che richiedono autorizzazioni specifiche per la rimozione.
  • Modifiche a dati autorevoli, che possono richiedere approvazione umana.
  • Notifiche già inviate, che non possono essere semplicemente annullate.

La progettazione delle compensazioni deve essere parte del catalogo dei tool, non una decisione improvvisata dall'LLM dopo un errore.

9. Isolamento dei sub-agent: un agente specializzato non è un processo fidato

Un workflow può delegare attività a sub-agent specializzati.

Per esempio:

GeoCoordinator
      |
      +-- RainfallAgent
      |
      +-- TerrainAgent
      |
      +-- InfrastructureAgent
      |
      +-- RiskVerificationAgent

Il vantaggio è la specializzazione. Il rischio è l'ampliamento della superficie di attacco.

Un sub-agent non dovrebbe ereditare automaticamente l'intera cronologia del coordinatore, tutte le sue credenziali o la capacità di invocare qualsiasi tool.

Nella preview Microsoft Dynamic Workflows, le invocazioni dei sub-agent utilizzano sessioni isolate e stateless, con istruzioni, modelli, strumenti e timeout propri. Non ricevono automaticamente la conversation history o la sandbox del coordinatore.

Questo è un buon punto di partenza, ma non sostituisce l'isolamento infrastrutturale.

Capability-based execution

Ogni sub-agent dovrebbe ricevere soltanto le capability necessarie.

RainfallAgent
    READ rainfall observations
    READ station metadata
    NO write access
    NO publishing permissions

TerrainAgent
    READ elevation datasets
    EXECUTE terrain analysis
    NO access to notifications

PublisherAgent
    READ approved outputs
    PUBLISH to approved folders
    NO arbitrary service access

Il controllo deve essere imposto dal gateway dei tool e dalle identità utilizzate verso i servizi, non soltanto da istruzioni testuali come "non pubblicare dati".

In Azure, Managed Identity, Azure RBAC, Key Vault e isolamento di rete possono contribuire a questo modello, purché le identità siano effettivamente separate secondo i confini di autorizzazione richiesti.

10. Context engineering: la memoria dell'agente non è lo stato del workflow

Un altro errore frequente consiste nell'utilizzare la conversation history come archivio dello stato operativo.

La memoria del modello è utile per mantenere obiettivi, vincoli e informazioni semantiche. Non dovrebbe essere la fonte autorevole per determinare se un job è completato, quale output è stato pubblicato o quali autorizzazioni sono state concesse.

Propongo di separare quattro livelli:

+----------------------------------+
| Semantic Context                 |
| Goal, assumptions, constraints   |
+----------------------------------+
| Execution State                  |
| Node status, retries, timestamps |
+----------------------------------+
| Artifact Store                   |
| Raster, JSON, logs, results      |
+----------------------------------+
| Audit & Authorization            |
| Identity, approvals, provenance  |
+----------------------------------+

Il modello dovrebbe ricevere soltanto il contesto necessario per decidere il piano e, alla fine, interpretare i risultati.

Gli output voluminosi dovrebbero essere conservati in storage e rappresentati attraverso riferimenti immutabili o versionati, accompagnati da metadata come checksum, schema, sistema di riferimento e provenienza.

Questo evita che raster, grandi FeatureSet, log o migliaia di record GIS vengano inseriti nella context window senza alcun beneficio.

11. GeoAgent: un laboratorio architetturale con ArcGIS e Azure

Immaginiamo di voler realizzare un agente che risponda alla richiesta:

Analizza le precipitazioni delle ultime 24 ore, individua le aree potenzialmente critiche e produci una mappa delle infrastrutture esposte.

Il modello non dovrebbe generare direttamente una mappa di rischio basandosi soltanto sul testo. Deve selezionare strumenti GIS deterministici, ciascuno con input, output e limiti ben definiti.

Pipeline proposta

Weather / Rainfall API
          |
          v
   Observation Validation
          |
          v
   Spatial Interpolation
      IDW / Spline
          |
          v
   Rainfall Raster
          |
          +------------------+
          |                  |
          v                  v
    Terrain Data       Asset Inventory
          |                  |
          +---------+--------+
                    |
                    v
             Spatial Analysis
                    |
                    v
             Exposure Overlay
                    |
                    v
             Result Validation
                    |
                    v
             ArcGIS Publishing
                    |
                    v
               WebMap / App

Una possibile implementazione utilizza:

  • C#/.NET: API di ingresso, validazione, orchestrazione e integrazione enterprise.
  • Azure Durable Functions: scheduling durevole, retry e recovery.
  • Azure SQL: operation ledger, metadata, policy e audit applicativo.
  • Azure Blob Storage: artifact store per input e output voluminosi.
  • ArcGIS Enterprise: geoprocessing, analisi raster, feature service e pubblicazione.
  • LLM: interpretazione della richiesta, costruzione del piano e sintesi finale.

È importante non confondere l'interpolazione delle precipitazioni con una simulazione idrologica o idraulica completa.

IDW e Spline producono superfici interpolate a partire dalle osservazioni. Per modellare runoff, propagazione delle piene o dinamiche fisiche occorrono modelli e dati aggiuntivi, opportunamente calibrati e validati.

Inoltre l'eventuale esecuzione di Spatial Analyst richiede di verificare disponibilità delle capability e licenze nella versione e nell'ambiente ArcGIS effettivamente distribuiti.

12. Un adapter ArcGIS robusto deve conoscere il ciclo di vita dei job

Un adapter per un servizio ArcGIS Geoprocessing asincrono non dovrebbe limitarsi a invocare SubmitJob e attendere indefinitamente.

Deve modellare esplicitamente gli stati del job remoto:

NotSubmitted
      |
      v
  Submitted
      |
      v
   Executing
      |
      +----> Succeeded
      |
      +----> Failed
      |
      +----> Cancelled
      |
      +----> TimedOut

La gestione deve distinguere lo stato del job ArcGIS dallo stato dell'Activity Azure Functions.

Un job ArcGIS può continuare a essere eseguito anche quando il worker che lo ha avviato non è più disponibile. Per questo è preferibile salvare l'identificatore del job e utilizzare un meccanismo di polling o riconciliazione durevole.

Per processi molto lunghi, il pattern può diventare:

Submit GP Job
     |
     v
Persist Job ID
     |
     v
Durable Timer
     |
     v
Check GP Status
     |
     +-- Running --> Durable Timer
     |
     +-- Success --> Fetch Results
     |
     +-- Failure --> Error Policy

Il polling non dovrebbe occupare un thread o una Function instance per tutta la durata del job.

Per i servizi GIS occorre inoltre definire timeout, frequenza di polling, politiche di cancellazione e comportamento in caso di perdita temporanea della connettività.

13. Observability: misurare il workflow, non soltanto i token

Un sistema agentico enterprise dovrebbe essere osservabile su più livelli.

Il livello LLM deve registrare modello, versione, token, latenza, versione del prompt e identificativo del piano generato.

Il livello workflow deve registrare durata dei nodi, retry, timeout, dipendenze, errori e stato complessivo.

Il livello GIS deve registrare servizio utilizzato, identificativo del job, tempi di elaborazione, parametri analitici, dataset e riferimenti agli output.

Una struttura di correlazione può essere:

TraceId
   |
   +-- PlanningSpan
   |
   +-- ValidationSpan
   |
   +-- WorkflowInstanceId
          |
          +-- Node: rainfall
          +-- Node: terrain
          +-- Node: risk
          +-- Node: publishing
                    |
                    +-- ArcGIS JobId

OpenTelemetry e Application Insights possono contribuire a questa osservabilità, ma occorre propagare esplicitamente gli identificatori di correlazione fra sistemi.

Il replay delle orchestrazioni richiede inoltre attenzione: log prodotti ingenuamente durante il replay possono essere duplicati. Dove disponibile, conviene utilizzare il replay-safe logger fornito dal runtime Durable Functions.

Metriche che misurerei

  • Planning latency e planning token cost.
  • Percentuale di piani rifiutati dal validator.
  • Numero di nodi e profondità media del DAG.
  • Parallelismo effettivo rispetto a quello teorico.
  • Retry per tool e per servizio esterno.
  • Numero di job remoti riconciliati dopo failure.
  • Workflow completion rate.
  • Tempo medio e percentile P95/P99 per nodo.
  • Costo per workflow completato.
  • Accuratezza e validità dei risultati GIS.

Una riduzione dei token non rappresenta automaticamente un miglioramento del sistema se aumentano i workflow falliti o diminuisce la qualità del risultato.

14. Sicurezza: il piano generato dall'LLM è una superficie di attacco

Un piano apparentemente valido può essere pericoloso anche senza contenere codice eseguibile.

Consideriamo alcuni scenari:

  • Tool escalation: il modello seleziona un tool di pubblicazione quando l'utente ha richiesto soltanto un'analisi.
  • Data exfiltration: un parametro contiene un endpoint esterno non autorizzato.
  • Resource exhaustion: il piano richiede centinaia di analisi raster molto costose.
  • Cross-tenant access: un nodo tenta di utilizzare dati appartenenti a un altro tenant.
  • Prompt injection: un dataset o documento esterno influenza il planner inducendolo a inserire operazioni non richieste.
  • Approval spoofing: un output intermedio dichiara falsamente che l'utente ha autorizzato un'azione.

Le contromisure devono essere applicate fuori dal modello:

Untrusted User / Tool Data
             |
             v
        LLM Planner
             |
             v
        Schema Validator
             |
             v
        Policy Decision
             |
             v
       Approval Gateway
             |
             v
        Tool Dispatcher
             |
             v
     Authorized Execution

Un'approvazione dovrebbe essere un evento autenticato e correlato a una specifica operazione, non una proprietà booleana modificabile dal modello.

Il tool dispatcher dovrebbe risolvere le credenziali dal contesto server-side, evitando che il piano possa scegliere liberamente identità, segreti o endpoint.

15. Benchmark Microsoft: cosa dimostrano realmente i numeri

Nel proprio annuncio, Microsoft ha confrontato un normale reasoning loop con Dynamic Workflows su un benchmark sintetico di analisi di dieci servizi.

I risultati riportati sono:

MetricaReasoning loopDynamic Workflow
Token utilizzati99.0976.781
Latenza247,1 s12,7 s
Riduzione token—93,1%
Riduzione latenza—95,1%

I numeri sono notevoli, ma vanno interpretati correttamente. Il benchmark riguarda un task specifico, strutturato e adatto alla parallelizzazione. Non significa che qualsiasi workflow agentico possa ottenere automaticamente riduzioni equivalenti.

Il vantaggio dipende soprattutto da tre fattori:

  • Le attività indipendenti possono essere eseguite in parallelo.
  • Gli output intermedi non devono attraversare continuamente il modello.
  • Il numero di round-trip LLM viene drasticamente ridotto.

Un workflow che richiede decisioni semantiche dopo ogni passaggio potrebbe invece beneficiare meno di questo modello.

16. Il trade-off: meno autonomia durante l'esecuzione, più affidabilità

Separare pianificazione ed esecuzione introduce anche un limite.

Un DAG statico non può adattarsi arbitrariamente a qualsiasi informazione inattesa. Se un risultato intermedio richiede una nuova strategia, il workflow deve prevedere una decisione condizionale oppure una fase esplicita di replanning.

Per questo considero particolarmente interessante un modello ibrido:

LLM Planning
      |
      v
Validated DAG
      |
      v
Deterministic Execution
      |
      +-- Expected Result
      |       |
      |       v
      |   Continue DAG
      |
      +-- Unexpected Result
              |
              v
        Controlled Replan
              |
              v
        New Validation
              |
              v
        Resume Execution

Il replanning deve essere limitato e tracciato. Ogni nuovo piano deve essere nuovamente validato, e il sistema deve conoscere quali operazioni precedenti siano già state completate.

Non dovrebbe essere possibile aggirare un rifiuto del validator semplicemente generando ripetutamente nuovi piani.

17. Verso una nuova architettura: il GeoAgent come compilatore di workflow geografici

La prospettiva più interessante è considerare l'LLM non come il motore di esecuzione, ma come un compilatore semantico.

L'utente esprime un obiettivo in linguaggio naturale. Il modello lo traduce in una rappresentazione intermedia tipizzata. Il sistema valida questa rappresentazione, la ottimizza e la esegue utilizzando strumenti GIS affidabili.

Natural Language Goal
          |
          v
      LLM Planner
          |
          v
    GeoWorkflow IR
          |
          v
   Semantic Validation
          |
          v
   Optimization Passes
          |
          v
    Execution Plan
          |
          v
 Durable GIS Runtime
          |
          v
 Verified GeoArtifacts

Questa analogia con un compilatore è particolarmente potente.

La rappresentazione intermedia potrebbe contenere informazioni tipizzate come:

  • Sistema di riferimento spaziale.
  • Tipo geometrico.
  • Risoluzione raster.
  • Unità di misura.
  • Estensione geografica.
  • Dipendenze tra dataset.
  • Requisiti di licenza e capability GIS.
  • Classificazione dei dati.
  • Stima del costo computazionale.

Il validator potrebbe rifiutare un'operazione che combina raster con sistemi di riferimento incompatibili, utilizza unità di misura non coerenti oppure richiede capability non disponibili.

Un optimizer potrebbe invece individuare acquisizioni parallelizzabili, eliminare elaborazioni duplicate, riutilizzare risultati già presenti nello storage o selezionare differenti backend di elaborazione.

È importante distinguere ciò che è già disponibile da ciò che rappresenta una possibile evoluzione progettuale: questa GeoWorkflow IR è una proposta architetturale, non un prodotto Esri o Microsoft attualmente disponibile con tale nome.

18. Oltre il DAG: workflow gerarchici, feedback loop e sistemi autonomi

Il DAG è ideale per rappresentare dipendenze acicliche. Non descrive però naturalmente sistemi che devono reagire indefinitamente a nuovi eventi.

Un sistema di monitoraggio territoriale continuo può richiedere cicli di osservazione, analisi, verifica e aggiornamento.

La soluzione non è introdurre cicli arbitrari dentro un DAG non controllato, ma comporre workflow durevoli di durata limitata attraverso eventi, sub-orchestrazioni e nuove istanze.

Observation Event
       |
       v
Analysis Workflow
       |
       v
Verification
       |
       +-- No Change --> Archive
       |
       +-- Relevant Change
                  |
                  v
             New Event
                  |
                  v
          Follow-up Workflow

In questo modo ogni esecuzione rimane identificabile, verificabile e soggetta a quote, mentre il sistema complessivo può funzionare continuamente.

È una distinzione importante per il futuro degli agenti persistenti: persistenza della responsabilità non significa esecuzione illimitata di un singolo processo o di una singola conversazione LLM.

19. Checklist di produzione

Prima di portare in produzione un'architettura agentic workflow, verificherei almeno questi aspetti:

  • Il piano viene validato prima dell'esecuzione.
  • Ogni tool è registrato in un catalogo server-side.
  • Gli input sono tipizzati e soggetti a limiti.
  • Le autorizzazioni vengono verificate sul backend.
  • Le operazioni con effetti esterni hanno idempotency key e riconciliazione.
  • Gli orchestratori rispettano i vincoli di determinismo del replay.
  • I job remoti possono essere recuperati dopo un crash.
  • Gli output voluminosi sono esternalizzati dalla history.
  • I sub-agent hanno capability limitate.
  • Le approvazioni sono eventi autenticati.
  • Il parallelismo è limitato anche a livello di risorsa condivisa.
  • Le modifiche ai workflow già attivi sono gestite con versioning.
  • Gli audit log sono protetti da modifiche non autorizzate.
  • Le metriche misurano correttezza, costo e affidabilità, non soltanto latenza.
  • Esistono test di fault injection per crash, timeout, duplicazioni e retry.

20. Conclusione: l'LLM non deve diventare il transaction manager

Dynamic Workflows rappresenta un passaggio significativo nell'evoluzione delle architetture agentiche.

Non perché renda i modelli più intelligenti, ma perché riconosce esplicitamente che intelligenza, autorizzazione ed esecuzione affidabile sono problemi differenti.

Il modello interpreta obiettivi ambigui e propone piani. Il validator controlla che quei piani siano ammissibili. Il workflow engine esegue le attività rispettando dipendenze, retry e checkpoint. I tool applicano le operazioni reali attraverso API e identità autorizzate.

Nel mondo GIS questa separazione è ancora più importante: un LLM può scegliere quali analisi geospaziali effettuare, ma la correttezza geometrica, statistica e fisica deve rimanere responsabilità di algoritmi, dati e procedure verificabili.

La prossima generazione di GeoAgent potrebbe quindi non essere un chatbot con accesso a qualche geoprocessing tool, ma un vero sistema capace di compilare richieste territoriali in workflow geografici tipizzati, verificabili, riproducibili e osservabili.

La direzione è chiara: l'LLM definisce l'intenzione, il piano diventa un contratto e il runtime garantisce l'esecuzione. L'autonomia utile nasce quando il ragionamento probabilistico incontra un'infrastruttura deterministica.

Riferimenti tecnici