RunPod
runpodThe Cloud Built for AI - GPU cloud computing platform for AI and machine learning workloads
Acciones disponibles (13)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create RunPod ClusterRUNPOD_CREATE_CLUSTERAcciónTool to create a new GPU cluster for multi-node distributed computing workloads on RunPod. Use when you need to deploy multiple pods with shared configuration for parallel processing, ML training, or HPC workloads.
RUNPOD_CREATE_CLUSTERAcciónTool to create a new GPU cluster for multi-node distributed computing workloads on RunPod. Use when you need to deploy multiple pods with shared configuration for parallel processing, ML training, or HPC workloads.
Parámetros de entrada
envobject[]Optional list of environment variables to set in the container. Each entry should be a dict with 'key' and 'value' fields.
typestringObligatorioenumType of cluster to create: APPLICATION for general-purpose workloads, TRAINING for ML training jobs, or SLURM for high-performance computing with SLURM scheduler.
APPLICATIONTRAININGSLURMportsstringOptional comma-separated list of ports to expose on the pods.
pod_countintegerObligatorioInteger specifying the number of pods in the cluster. Must be at least 1.
start_sshbooleanOptional flag to enable SSH access on each pod. Default is false.
image_namestringOptional Docker image name to use for the pods. If not specified, the template's default image is used.
throughputintegerOptional network throughput specification for the volume in MB/s.
volume_keystringOptional encryption key for the volume.
deploy_costnumberOptional maximum deployment cost threshold. If specified, deployment will fail if the estimated cost exceeds this value.
docker_argsstringOptional Docker run arguments to pass when starting the container.
gpu_type_idstringObligatorioString identifier for the GPU type to use in the cluster (e.g., 'NVIDIA GeForce RTX 3070', 'NVIDIA A100 80GB PCIe').
template_idstringOptional template ID to use for pod configuration. References a pre-configured pod template with specific Docker image and settings.
cluster_namestringOptional name to identify the cluster. If not provided, a default name will be generated.
volume_in_gbintegerOptional size in GB for the persistent volume to attach to each pod.
start_jupyterbooleanOptional flag to automatically start JupyterLab on each pod. Default is false.
data_center_idstringOptional data center ID to specify the geographical location for cluster deployment.
min_cuda_versionstringOptional minimum CUDA version required for the cluster.
gpu_count_per_podintegerObligatorioInteger specifying the number of GPUs per pod. Must be at least 1.
network_volume_idstringOptional network volume ID to attach to all pods in the cluster for shared storage.
volume_mount_pathstringOptional path where the volume should be mounted inside the container.
container_disk_in_gbintegerOptional size in GB for the container disk. This is ephemeral storage that is reset when the pod restarts.
allowed_cuda_versionsstring[]Optional list of allowed CUDA versions for the cluster.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create SecretRUNPOD_CREATE_SECRETAcciónTool to create a new secure secret in RunPod for credential management. Use when you need to store sensitive values like API keys, passwords, or tokens that will be accessible in pods and endpoints via environment variables (RUNPOD_SECRET_<name>).
RUNPOD_CREATE_SECRETAcciónTool to create a new secure secret in RunPod for credential management. Use when you need to store sensitive values like API keys, passwords, or tokens that will be accessible in pods and endpoints via environment variables (RUNPOD_SECRET_<name>).
Parámetros de entrada
namestringObligatorioUnique identifier name for the secret. This name will be used to reference the secret in pods and endpoints (accessible via environment variable RUNPOD_SECRET_<name>). Must be unique within your account.
valuestringObligatorioThe secret value to store securely. This will be encrypted and stored securely by RunPod.
descriptionstringOptional human-readable description of what this secret is used for. Helps with secret management and documentation.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete Container Registry AuthenticationRUNPOD_DELETE_REGISTRY_AUTHAcciónTool to delete container registry authentication from RunPod. Use when you need to remove stored registry credentials.
RUNPOD_DELETE_REGISTRY_AUTHAcciónTool to delete container registry authentication from RunPod. Use when you need to remove stored registry credentials.
Parámetros de entrada
registry_auth_idstringObligatorioThe ID of the container registry authentication to delete. This is the unique identifier returned when the registry authentication was created.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete TemplateRUNPOD_DELETE_TEMPLATEAcciónTool to remove a RunPod template via GraphQL mutation. Use when you need to delete a template that is no longer needed. The template must not be in use by any pods or assigned to any serverless endpoints, otherwise the operation will fail.
RUNPOD_DELETE_TEMPLATEAcciónTool to remove a RunPod template via GraphQL mutation. Use when you need to delete a template that is no longer needed. The template must not be in use by any pods or assigned to any serverless endpoints, otherwise the operation will fail.
Parámetros de entrada
template_namestringObligatorioThe name of the template to delete. The template must not be in use by any pods or assigned to any serverless endpoints.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get GPU TypesRUNPOD_GET_GPU_TYPESAcciónTool to retrieve available GPU types and their specifications, pricing, and availability from RunPod. Use when you need to find GPU options for deployment.
RUNPOD_GET_GPU_TYPESAcciónTool to retrieve available GPU types and their specifications, pricing, and availability from RunPod. Use when you need to find GPU options for deployment.
Parámetros de entrada
inputobjectFilter options for querying GPU types.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get authenticated user infoRUNPOD_GET_MYSELFAcciónRetrieve basic information about the authenticated user including ID, email, and security settings. Use this to get the current user's ID, email address, terms of service status, and MFA settings. Note: Access to financial fields (balance, spending, etc.) requires elevated API key permissions.
RUNPOD_GET_MYSELFAcciónRetrieve basic information about the authenticated user including ID, email, and security settings. Use this to get the current user's ID, email address, terms of service status, and MFA settings. Note: Access to financial fields (balance, spending, etc.) requires elevated API key permissions.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Pod DetailsRUNPOD_GET_PODAcciónRetrieve details of a specific RunPod pod by its unique pod ID. Returns pod configuration including GPU count, memory, cost, and status. Use when you need to check the current state or configuration of an existing pod.
RUNPOD_GET_PODAcciónRetrieve details of a specific RunPod pod by its unique pod ID. Returns pod configuration including GPU count, memory, cost, and status. Use when you need to check the current state or configuration of an existing pod.
Parámetros de entrada
pod_idstringObligatorioThe unique identifier of the pod to retrieve. This is the pod ID assigned by RunPod when the pod was created.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List CPU TypesRUNPOD_LIST_CPU_TYPESAcciónTool to retrieve available CPU types and their specifications from RunPod. Use when you need to view CPU options for provisioning pods or selecting hardware configurations.
RUNPOD_LIST_CPU_TYPESAcciónTool to retrieve available CPU types and their specifications from RunPod. Use when you need to view CPU options for provisioning pods or selecting hardware configurations.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Save Serverless EndpointRUNPOD_SAVE_ENDPOINTAcciónTool to create or update a RunPod serverless endpoint with GPU configuration and scaling settings. Use when configuring new GPU-accelerated serverless endpoints or modifying existing endpoint parameters. Include 'id' parameter to update an existing endpoint, omit it to create a new one.
RUNPOD_SAVE_ENDPOINTAcciónTool to create or update a RunPod serverless endpoint with GPU configuration and scaling settings. Use when configuring new GPU-accelerated serverless endpoints or modifying existing endpoint parameters. Include 'id' parameter to update an existing endpoint, omit it to create a new one.
Parámetros de entrada
idstringEndpoint ID to update an existing endpoint. If provided, the mutation will update the existing endpoint instead of creating a new one. Omit this field to create a new endpoint.
namestringObligatorioName of the endpoint (required for creation). Must be a descriptive identifier for the serverless endpoint.
gpu_idsstringObligatorioGPU type identifier for the endpoint (required for creation). Examples: 'NVIDIA RTX A4000', 'NVIDIA A40', 'NVIDIA RTX A5000'. Specify the exact GPU model string from RunPod's available GPU types.
locationsstringComma-separated list of data center locations where the endpoint should run. Example: 'US-CA-1,US-OR-1'. If not specified, RunPod will choose automatically.
scaler_typestringType of autoscaling algorithm to use. Options: 'QUEUE_DELAY' (scale based on queue wait time), 'REQUEST_COUNT' (scale based on number of requests). QUEUE_DELAY is recommended for most use cases.
template_idstringObligatorioTemplate ID for the endpoint configuration (required for creation). This is the ID of a pre-configured template in your RunPod account.
workers_maxintegerMaximum number of workers (GPU instances) to scale up to. This is the upper limit for autoscaling. Must be >= workers_min.
workers_minintegerMinimum number of workers (GPU instances) to keep running. Set to 0 to allow scaling down to zero when idle. Set to 1 or higher to maintain always-on capacity.
idle_timeoutintegerIdle timeout in seconds before workers are scaled down. Workers will be terminated after being idle for this duration. Common values: 5, 10, 30, 60.
scaler_valueintegerTarget value for the scaler. For QUEUE_DELAY: target delay in seconds before scaling up. For REQUEST_COUNT: target number of requests per worker. Common values: 1-10 for QUEUE_DELAY, 1-100 for REQUEST_COUNT.
network_volume_idstringNetwork volume ID to attach to the endpoint for persistent storage. If specified, this network volume will be mounted to all workers.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Save Container Registry AuthenticationRUNPOD_SAVE_REGISTRY_AUTHAcciónTool to save container registry authentication credentials for accessing private Docker images in RunPod. Use when you need to store credentials for a private container registry.
RUNPOD_SAVE_REGISTRY_AUTHAcciónTool to save container registry authentication credentials for accessing private Docker images in RunPod. Use when you need to store credentials for a private container registry.
Parámetros de entrada
namestringObligatorioA user-defined name for the container registry authentication credential. This name must be unique across all registry authentications in your account.
passwordstringObligatorioThe password for authenticating with the container registry.
usernamestringObligatorioThe username for authenticating with the container registry.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Save TemplateRUNPOD_SAVE_TEMPLATEAcciónTool to create a new RunPod template or update an existing one with container configuration. Use when you need to define reusable pod/serverless configurations with specific images, environment variables, and resource allocations. For serverless templates, always set volumeInGb to 0.
RUNPOD_SAVE_TEMPLATEAcciónTool to create a new RunPod template or update an existing one with container configuration. Use when you need to define reusable pod/serverless configurations with specific images, environment variables, and resource allocations. For serverless templates, always set volumeInGb to 0.
Parámetros de entrada
envobject[]List of environment variables to set in the container. Each entry must have 'key' and 'value' fields. Pass empty array if no env vars needed.
namestringObligatorioUnique name for the template. Must be unique across your account. Used to identify the template for pod or serverless deployment.
portsstringComma-separated list of ports to expose from the container. Format: 'port/protocol' or just 'port'. Example: '8080/http,8888/http'
readmestringMarkdown-formatted readme documentation for the template. Use this to document usage instructions, requirements, and configuration details.
image_namestringObligatorioDocker image to use for the template. Can be from Docker Hub or a private registry. Include the full image path with tag.
docker_argsstringAdditional Docker arguments to pass when starting the container. Use this for advanced Docker configuration. Leave empty if not needed.
template_idstringID of an existing template to update. Leave empty to create a new template. Provide the template ID to modify an existing template.
volume_in_gbintegerObligatorioNetwork volume size in gigabytes for persistent storage. Set to 0 if no persistent volume is needed. For serverless templates, always use 0.
is_serverlessbooleanObligatorioWhether this template is for serverless endpoints (true) or standard pods (false). Serverless templates must have volumeInGb set to 0.
volume_mount_pathstringMount path for the network volume inside the container. Only applicable if volumeInGb > 0. Example: /workspace or /data
container_disk_in_gbintegerObligatorioContainer disk size in gigabytes. This is ephemeral storage that gets reset on pod restart. Minimum 10 GB recommended. Used for temporary files and cache.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update Registry AuthRUNPOD_UPDATE_REGISTRY_AUTHAcciónTool to update existing container registry authentication credentials in RunPod. Use when you need to modify the username or password for an existing registry authentication.
RUNPOD_UPDATE_REGISTRY_AUTHAcciónTool to update existing container registry authentication credentials in RunPod. Use when you need to modify the username or password for an existing registry authentication.
Parámetros de entrada
idstringObligatorioThe authentication credential identifier to update
passwordstringObligatorioThe new password for registry authentication
usernamestringObligatorioThe new username for registry authentication
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update User SettingsRUNPOD_UPDATE_USER_SETTINGSAcciónTool to update current user settings (e.g., SSH public key) in RunPod. Use when you need to configure SSH access to pods by setting the user's SSH public key.
RUNPOD_UPDATE_USER_SETTINGSAcciónTool to update current user settings (e.g., SSH public key) in RunPod. Use when you need to configure SSH access to pods by setting the user's SSH public key.
Parámetros de entrada
pub_keystringObligatorioSSH public key to associate with the user account. This key will be used for SSH access to pods. Must be a valid SSH public key in OpenSSH format (e.g., 'ssh-rsa AAAAB3...' or 'ssh-ed25519 AAAAC3...').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not