AGBCLOUD

Appearance

Troubleshooting ​

Common Issues ​

Session Creation Fails

python
from agb import AGB
from agb.session_params import CreateSessionParams

params = CreateSessionParams(image_id="agb-code-space-1")
result = agb.create(params)
if not result.success:
    print(f"Error: {result.error_message}")
    # Common causes:
    # - Invalid API key
    # - Network connectivity issues
    # - Service temporarily unavailable
    # - Account limits exceeded

Session Becomes Unresponsive

python
from agb import AGB
from agb.session_params import CreateSessionParams

# Check session health
info_result = session.info()
if not info_result.success:
    print("Session may be unresponsive, creating new session...")
    agb.delete(session)  # Clean up old session
    params = CreateSessionParams(image_id="agb-code-space-1")
    result = agb.create(params)  # Create new session

Memory or Resource Limits

python
from agb import AGB
from agb.session_params import CreateSessionParams

# Monitor resource usage and recreate sessions periodically
operation_count = 0
max_operations_per_session = 100

for task in tasks:
    if operation_count >= max_operations_per_session:
        # Recreate session to free resources
        agb.delete(session)
        params = CreateSessionParams(image_id="agb-code-space-1")
        result = agb.create(params)

        if result.success:
            session = result.session
            operation_count = 0
        else:
            print(f"Failed to recreate session: {result.error_message}")
            break

    # Execute task
    session.code.run_code(task["code"], "python")
    operation_count += 1

Pause/Resume Issues

python
from agb import AGB

# Issue: Cannot delete paused session
# Solution: Resume first, then delete
get_result = agb.get_session(session.session_id)
if get_result.success and hasattr(get_result.data, 'status'):
    if get_result.data.status == "PAUSED":
        print("Session is paused, resuming before delete...")
        agb.resume(session)

delete_result = agb.delete(session)

# Issue: Pause/resume timeout
# Solution: Increase timeout and adjust poll interval
pause_result = agb.pause(session, timeout=600, poll_interval=5)
if not pause_result.success:
    print(f"Pause failed: {pause_result.error_message}")
    # Retry or handle error

# Issue: Session stuck in transitional state (PAUSING/RESUMING)
# Solution: Wait and check status, or contact support
import time
get_result = agb.get_session(session.session_id)
if get_result.success and hasattr(get_result.data, 'status'):
    status = get_result.data.status
    if status in ["PAUSING", "RESUMING"]:
        print(f"Session in transitional state: {status}")
        print("Waiting for state to stabilize...")
        time.sleep(10)
        # Check status again
        get_result = agb.get_session(session.session_id)