Skip to main content

Agi Inc Bubble

AGI Agent integration for browser automation and task execution

Quick Start​

import { AGIIncBubble } from '@bubblelab/bubble-core';
import { CredentialType } from '@bubblelab/shared-schemas';
const result = await new AGIIncBubble({
  operation: 'create_session',
  credentials: {
    [CredentialType.AGI_API_KEY]: process.env.AGI_API_KEY as string,
  },
}).action();

Operation Details​

create_session​

operation 'create_session' required
Create a new agent session with a browser environment
agent_name 'agi-0' | 'agi-0-fast'
Agent model to use
webhook_url string
URL to receive webhook notifications for session events
restore_from_session_id string
Restore session from a specific session snapshot
restore_default_environment_from_user_id string
Restore from user default environment snapshot
enable_memory_snapshot boolean
Enable memory snapshots for faster restoration
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

list_sessions​

operation 'list_sessions' required
Get all sessions for the authenticated user
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

get_session​

operation 'get_session' required
Get details for a specific session
session_id string required
The UUID of the session to retrieve
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

delete_session​

operation 'delete_session' required
Delete a specific session and cleanup resources
session_id string required
The UUID of the session to delete
save_snapshot_mode 'none' | 'memory' | 'filesystem'
Snapshot mode when deleting
save_as_default boolean
Set snapshot as user default environment
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

delete_all_sessions​

operation 'delete_all_sessions' required
Delete all sessions for the authenticated user
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

send_message​

operation 'send_message' required
Send a message to the agent to start a task or respond
session_id string required
The UUID of the session
message string required
The message text to send to the agent
start_url string
Optional starting URL for the agent to navigate to
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

get_status​

operation 'get_status' required
Get the current execution status of a session
session_id string required
The UUID of the session
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

get_messages​

operation 'get_messages' required
Poll for messages and updates from the agent
session_id string required
The UUID of the session
after_id number
Return only messages with ID greater than this value
sanitize boolean
Filter out system messages and internal prompts
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

pause_session​

operation 'pause_session' required
Temporarily pause task execution
session_id string required
The UUID of the session to pause
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

resume_session​

operation 'resume_session' required
Resume a paused task
session_id string required
The UUID of the session to resume
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

cancel_session​

operation 'cancel_session' required
Cancel the current task execution
session_id string required
The UUID of the session to cancel
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)
operation 'navigate' required
Navigate the browser to a specific URL
session_id string required
The UUID of the session
url string required
Absolute URL to navigate to
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)

get_screenshot​

operation 'get_screenshot' required
Capture a screenshot of the current browser state
session_id string required
The UUID of the session
credentials Record<CredentialType,string>
Object mapping credential types to values (injected at runtime)