Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Interrompere una sessione in corso

L'StopRuntimeSessionoperazione consente di terminare immediatamente le sessioni di Active Agent AgentCore Runtime per una corretta pulizia delle risorse e una gestione del ciclo di vita delle sessioni.

Quando viene chiamata, questa operazione interrompe istantaneamente la sessione specificata e interrompe tutte le risposte in streaming in corso. Ciò consente di rilasciare correttamente le risorse di sistema e impedisce l'accumulo di sessioni orfane.

Utilizzalo StopRuntimeSession in questi scenari:

Prerequisiti

Per utilizzarlo StopRuntimeSession, è necessario:

Formato della risposta

Formato di risposta previsto per operazioni riusciteStopRuntimeSession.

{
    "ResponseMetadata": {
        "RequestId": "12345678-1234-1234-1234-123456789012",
        "HTTPStatusCode": 200
    }
}

Gestione degli errori

Risposte agli errori più comuni:

Il servizio ritorna RetryableConflictException (HTTP 409) quando la StopRuntimeSession chiamata arriva mentre il servizio è ancora in fase di provisioning o sta interrompendo la sessione. Questa condizione è transitoria e riprovabile. Riprova con un breve backoff esponenziale invece di considerarlo un errore terminale. Gli AWS SDK riprovano automaticamente questa eccezione quando i tentativi predefiniti sono abilitati. Se hai disabilitato i tentativi o chiami l'API direttamente senza un AWS SDK (ad esempio, la richiesta HTTPS mostrata in precedenza), riprova tu stesso.

Best practice

Gestione del ciclo di vita delle sessioni

class SessionManager:
    def __init__(self, client, agent_arn):
        self.client = client
        self.agent_arn = agent_arn
        self.active_sessions = set()

    def invoke_agent(self, session_id, payload):
        """Invoke agent and track session"""
        try:
            response = self.client.invoke_agent_runtime(
                agentRuntimeArn=self.agent_arn,
                runtimeSessionId=session_id,
                payload=payload
            )
            self.active_sessions.add(session_id)
            return response
        except Exception as e:
            print(f"Failed to invoke agent: {e}")
            raise

    def stop_session(self, session_id):
        """Stop session and remove from tracking"""
        try:
            self.client.stop_runtime_session(
                agentRuntimeArn=self.agent_arn,
                runtimeSessionId=session_id,
                qualifier=endpoint_name
            )
            self.active_sessions.discard(session_id)
            print(f"Session {session_id} stopped")
        except Exception as e:
            print(f"Failed to stop session {session_id}: {e}")

    def cleanup_all_sessions(self):
        """Stop all tracked sessions"""
        for session_id in list(self.active_sessions):
            self.stop_session(session_id)

Raccomandazioni