Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Detener una sesión en ejecución

La StopRuntimeSession operación le permite terminar inmediatamente las sesiones de AgentCore ejecución de los agentes activas para limpiar los recursos y gestionar el ciclo de vida de la sesión de forma adecuada.

Cuando se invoca, esta operación termina instantáneamente la sesión especificada y detiene cualquier respuesta de transmisión en curso. Esto permite que los recursos del sistema se liberen correctamente y evita la acumulación de sesiones huérfanas.

Úselo StopRuntimeSession en los siguientes escenarios:

Requisitos previos

Para usarlo StopRuntimeSession, necesita:

Formato de las respuestas

Formato de respuesta esperado para operaciones exitosasStopRuntimeSession.

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

Gestión de errores

Respuestas de error comunes:

El servicio regresa RetryableConflictException (HTTP 409) cuando la StopRuntimeSession llamada llega mientras el servicio aún está aprovisionando o interrumpiendo la sesión. Esta condición es transitoria y se puede volver a intentar. Vuelva a intentarlo con un breve retroceso exponencial en lugar de tratarlo como una falla terminal. Los AWS SDK reintentan automáticamente esta excepción cuando están habilitados los reintentos predeterminados. Si inhabilitaste los reintentos o llamaste a la API directamente sin un AWS SDK (por ejemplo, la solicitud HTTPS que se mostró anteriormente), vuelve a intentarlo tú mismo.

Prácticas recomendadas

Administración del ciclo de sesiones

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)

Recomendaciones