Ricevi notifiche di avanzamento dal tuo AgentCore gateway
Le notifiche di avanzamento consentono alle destinazioni dei server MCP di segnalare i progressi incrementali in caso di chiamate agli strumenti di lunga durata. Quando il completamento di una chiamata allo strumento richiede tempo, il server può inviare notifications/progress eventi per tenere il client informato sullo stato dell'operazione. AgentCore Gateway inoltra queste notifiche dalle destinazioni del server MCP al client come blocchi di Server-Sent eventi (SSE).
Prerequisiti
Per ricevere notifiche sullo stato di avanzamento dal gateway:
-
Streaming di risposta abilitato: le notifiche di avanzamento vengono inviate come blocchi SSE durante una connessione aperta. Imposta streamingConfiguration.enableResponseStreaming su true nel tuo gateway. protocolConfiguration.mcp
-
Tipo di destinazione del server MCP: le notifiche di avanzamento provengono dalle destinazioni del server MCP.
-
Il client invia l'Accept: text/event-streamintestazione: il client deve richiedere una risposta SSE per ricevere eventi in streaming.
Come funzionano le notifiche di avanzamento
Quando un client effettua una tools/call richiesta con progressToken a nei parametri della richiesta, il server di destinazione MCP può inviare notifications/progress eventi durante l'esecuzione. Il gateway inoltra questi eventi al client come blocchi SSE prima del risultato finale dello strumento.
Ogni notifica di avanzamento include:
-
progressToken— Corrisponde al token fornito nella richiesta originale.
-
progress— Il valore di avanzamento corrente (numerico).
-
total— Valore totale opzionale che indica l'obiettivo di completamento.
-
message— Descrizione facoltativa leggibile dall'uomo dello stato attuale.
Esempi di codice
Esempio
- curl
-
-
Chiama uno strumento con un token di avanzamento:
curl -N -X POST \
https://mygateway-abcdefghij.gateway.bedrock-agentcore.us-west-2.amazonaws.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: text/event-stream" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
"jsonrpc": "2.0",
"id": "tool-call-1",
"method": "tools/call",
"params": {
"name": "analyzeDataset",
"arguments": {
"datasetId": "ds-12345"
},
"_meta": {
"progressToken": "progress-1"
}
}
}'
Il gateway restituisce un flusso SSE con notifiche di avanzamento seguite dal risultato finale:
event: message
data: {"jsonrpc":"2.0","method":"notifications/progress","params":{"progressToken":"progress-1","progress":1,"total":4,"message":"Loading dataset..."}}
event: message
data: {"jsonrpc":"2.0","method":"notifications/progress","params":{"progressToken":"progress-1","progress":2,"total":4,"message":"Running analysis..."}}
event: message
data: {"jsonrpc":"2.0","method":"notifications/progress","params":{"progressToken":"progress-1","progress":3,"total":4,"message":"Generating report..."}}
event: message
data: {"jsonrpc":"2.0","method":"notifications/progress","params":{"progressToken":"progress-1","progress":4,"total":4,"message":"Complete"}}
event: message
data: {"jsonrpc":"2.0","id":"tool-call-1","result":{"content":[{"type":"text","text":"Analysis complete. Found 3 anomalies in dataset ds-12345."}]}}
- Python requests package
-
-
import requests
import json
import sseclient
gateway_url = "https://mygateway-abcdefghij.gateway.bedrock-agentcore.us-west-2.amazonaws.com/mcp"
headers = {
"Content-Type": "application/json",
"Accept": "text/event-stream",
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
# Call tool with progress token (streaming response)
response = requests.post(gateway_url, headers=headers, json={
"jsonrpc": "2.0",
"id": "tool-call-1",
"method": "tools/call",
"params": {
"name": "analyzeDataset",
"arguments": {"datasetId": "ds-12345"},
"_meta": {"progressToken": "progress-1"}
}
}, stream=True)
# Process SSE events
client = sseclient.SSEClient(response)
for event in client.events():
data = json.loads(event.data)
if data.get("method") == "notifications/progress":
params = data["params"]
print(f"Progress: {params['progress']}/{params.get('total', '?')} - {params.get('message', '')}")
elif "result" in data:
print(f"Tool result: {data['result']}")
break
- MCP Client
-
-
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
import asyncio
async def progress_handler(progress_token, progress, total, message=None):
"""Handle progress notifications."""
print(f"[{progress}/{total}] {message or ''}")
async def use_progress(url, token):
headers = {"Authorization": f"Bearer {token}"}
async with streamablehttp_client(url=url, headers=headers) as (
read_stream, write_stream, _
):
async with ClientSession(
read_stream, write_stream,
progress_handler=progress_handler
) as session:
await session.initialize()
# Call tool with progress token - notifications handled by callback
result = await session.call_tool(
name="analyzeDataset",
arguments={"datasetId": "ds-12345"}
)
print(f"Tool result: {result}")
return result
asyncio.run(use_progress(
url="https://mygateway-abcdefghij.gateway.bedrock-agentcore.us-west-2.amazonaws.com/mcp",
token="YOUR_ACCESS_TOKEN"
))
- Strands MCP Client
-
-
from mcp.client.streamable_http import streamablehttp_client
from strands import Agent
from strands.tools.mcp import MCPClient
mcp_url = "https://mygateway-abcdefghij.gateway.bedrock-agentcore.us-west-2.amazonaws.com/mcp"
access_token = "YOUR_ACCESS_TOKEN"
mcp_client = MCPClient(
lambda: streamablehttp_client(
mcp_url, headers={"Authorization": f"Bearer {access_token}"}
)
)
# Strands handles streaming and progress notifications automatically
with mcp_client:
agent = Agent(tools=mcp_client.list_tools_sync())
response = agent("Analyze dataset ds-12345")
print(response)
