CLI Commands

ServisBOT CLI provides an interface for managing every aspect of your organization and bots.

Available Commands

  sb-cli login <organization>         Authenticates the servisbot-cli for use with your organization
  sb-cli bot <command>                Used to perform actions associated with bots
  sb-cli baas <command>               Used to perform actions associated with baas
  sb-cli endpoint <command>           Used to perform actions associated with endpoints
  sb-cli worker <command>             Used to perform actions associated with workers
  sb-cli blueprint <command>          Used to perform actions associated with blueprints
  sb-cli conversation <command>       Used to perform actions associated with conversations
  sb-cli secret <command>             Used to perform actions associated with secrets
  sb-cli goal <command>               Used to perform actions associated with goals
  sb-cli goal-conversion <command>    Used to perform actions associated with conversions
  sb-cli virtual-assistant <command>  Used to perform actions associated with virtual assistant
  sb-cli region <command>             Used to perform actions associated with regions
  sb-cli metric <command>             Used to perform actions associated with metrics
  sb-cli user <command>               Used to perform actions associated with users
  sb-cli role <command>               Used to perform actions associated with roles
  sb-cli export <command>             Used to perform actions associated with data exports
  sb-cli intent <command>             Used to perform actions associated with bot intents
  sb-cli job <command>                Used to perform actions associated with jobs
  sb-cli missed-input <command>       Used to perform actions associated with missed input
  sb-cli logs <command>               Used to perform actions associated with organization logs
  sb-cli auth-profile <command>       Used to perform actions associated with auth profiles
  sb-cli missed-intent <command>      Used to perform actions associated with missed intents

login

Authenticates the servisbot-cli for use with your organization

bot

Create and manage your bots

sb-cli bot create <json>                           Creates a bot from inline JSON or a file                                            
sb-cli bot delete <bot_name>                       Deletes a bot by the given name                                                     
sb-cli bot delete-intents <bot>                    Deletes a particular bots intents                                                  
sb-cli bot describe <bot_name>                     Describes a bot with the given name                                              
sb-cli bot list                                    Lists all available bots                                                           
sb-cli bot update <json>                           Updates a bot from inline JSON or a file                                            
sb-cli bot sync <bot_name>                         Finds all business intent workers in the bot and syncs against the public AI operator
sb-cli bot patch <name> <json_path> <replacement>  Patch to a particular piece of a bot. The JSON Path is where the patch will apply   
sb-cli bot download <name>                         Downloads a bot definition, saves all assets related to that bot to the current directory.
sb-cli bot watch                                   Watches a directory containing a manifest for changes - uploads any modified definitions
sb-cli bot upload <directory>                      Uploads a bot definition using the directory provided                              
sb-cli bot publish <name>                          Publish Intents

baas

Create and manage connectors

sb-cli baas create <json>     Creates a baas from inline JSON or a file path                                                           
sb-cli baas delete <alias>    Deletes a baas by the alias                                                                              
sb-cli baas describe <alias>  Describes a baas with the given alias                                                                 
sb-cli baas execute <json>    Executes a BAAS from inline JSON or a file                                                               
sb-cli baas list              Lists all available BAAS APIs                                                                            
sb-cli baas update <json>     Updates a BAAS from inline JSON or a file                                                               

endpoint

Create and manage endpoints

sb-cli login <organization>         Authenticates the servisbot-cli for use with your organization
sb-cli bot <command>                Used to perform actions associated with bots
sb-cli baas <command>               Used to perform actions associated with baas
sb-cli endpoint <command>           Used to perform actions associated with endpoints
sb-cli worker <command>             Used to perform actions associated with workers
sb-cli blueprint <command>          Used to perform actions associated with blueprints
sb-cli conversation <command>       Used to perform actions associated with conversations
sb-cli secret <command>             Used to perform actions associated with secrets
sb-cli goal <command>               Used to perform actions associated with goals
sb-cli goal-conversion <command>    Used to perform actions associated with conversions
sb-cli virtual-assistant <command>  Used to perform actions associated with virtual assistant
sb-cli region <command>             Used to perform actions associated with regions
sb-cli metric <command>             Used to perform actions associated with metrics
sb-cli user <command>               Used to perform actions associated with users
sb-cli role <command>               Used to perform actions associated with roles
sb-cli export <command>             Used to perform actions associated with data exports
sb-cli intent <command>             Used to perform actions associated with bot intents
sb-cli job <command>                Used to perform actions associated with jobs
sb-cli missed-input <command>       Used to perform actions associated with missed input
sb-cli logs <command>               Used to perform actions associated with organization logs
sb-cli auth-profile <command>       Used to perform actions associated with auth profiles
sb-cli missed-intent <command>      Used to perform actions associated with missed intents

worker

Create and manage workers.

sb-cli worker create <json>                         Creates a worker from inline JSON or a file                                        
sb-cli worker delete <worker_name>                  Deletes a worker by the given name                                                 
sb-cli worker describe <worker_id>                  Describes a worker with the given name                                          
sb-cli worker update <json>                         Updates a worker from inline JSON or a file                                        
sb-cli worker patch <id> <json_path> <replacement>  Patch to a particular piece of a worker. The JSON Path is where the patch will apply
sb-cli worker cycle-detection <worker_id>           Performs cycle detection on the given worker                                      

blueprint

Create bots from Blueprints

sb-cli blueprint list               Lists all available blueprints                                                                     
sb-cli blueprint build <json>       Builds a from a blueprint using inline JSON or a file                                              
sb-cli blueprint build-interactive  Builds a from a blueprint interactively

conversation

Monitor Conversations

sb-cli conversation create <endpoint>       Create a conversations                                                                     
sb-cli conversation watch <conversationId>  Watch a conversation                                                                       
sb-cli conversation export                  Begin export of all conversation data for your Organization                                

secret

Configure organization secrets

sb-cli secret create <json>                     Creates a secret from inline JSON or a file                                            
sb-cli secret delete <srn>                      Deletes a secret by the given srn                                                      
sb-cli secret describe <srn>                    Describes a secret with the given Srn                                               
sb-cli secret list                              Lists all available secrets                                                            
sb-cli secret update <json>                     Updates an secret from inline JSON or a file                                           
sb-cli secret create-interactive                Creates a secret interactively                                                        
sb-cli secret create-external-id <secret_name>  Creates a external id                                                               

goal

Create and view goals

sb-cli secret create <json>                     Creates a secret from inline JSON or a file                                            
sb-cli secret delete <srn>                      Deletes a secret by the given srn                                                      
sb-cli secret describe <srn>                    Describes a secret with the given Srn                                               
sb-cli secret list                              Lists all available secrets                                                            
sb-cli secret update <json>                     Updates an secret from inline JSON or a file                                           
sb-cli secret create-interactive                Creates a secret interactively                                                        
sb-cli secret create-external-id <secret_name>  Creates a external id                                                               

goal-conversion

Group goal interactions together

sb-cli goal-conversion create <json>                           Creates a conversion from inline JSON or a file path                    
sb-cli goal-conversion describe <bot_name> <conversion_name>   Describes a conversion for a particular bot                          
sb-cli goal-conversion list                                    Get a list of conversions                                               
sb-cli goal-conversion delete <bot_name> <conversion_name>     Deletes a conversion by the name for a particular bot                   
sb-cli goal-conversion update <json>                           Updates a Conversion from inline JSON or a file                         
sb-cli goal-conversion calculate <bot_name> [conversion_name]  Describes all conversions or a particular conversion for a given bot

virtual-assistant

Create and manage virtual assistants

sb-cli virtual-assistant create <json>                                 Creates a virtual assistant from inline JSON or a file          
sb-cli virtual-assistant delete <virtual_assistant_name>               Deletes a virtual assistant by the given name                   
sb-cli virtual-assistant describe <virtual_assistant_name>             Describes a virtual assistant with the given name            
sb-cli virtual-assistant update <json>                                 Updates a virtual assistant from inline JSON or a file          
sb-cli virtual-assistant list                                          Lists all available virtual assistants                          
sb-cli virtual-assistant train <virtual_assistant_name>                Trains a virtual assistant with the given name                  
sb-cli virtual-assistant dry-run <virtual_assistant_name> <utterance>  Performs a dry run routing attempt against a VA                
sb-cli virtual-assistant upsert-endpoint <virtual_assistant_name>      Upserts the inference endpoint associated with a virtual assistant
sb-cli virtual-assistant delete-endpoint <virtual_assistant_name>      Deletes the inference endpoint associated with a virtual assistant

region

Set your CLI region

sb-cli region set <region>  Sets the region to be used by the ServisBot CLI. Available regions: eu-1 and us1
sb-cli region show          Returns the region currently used by the CLI

metric

Pull data exports

sb-cli metric transaction <range>  Get metric transactions                                                                             
sb-cli metric response-time        Get metric response time                                                                           

user

Manage users and permissions

sb-cli user update <json>     Updates a user from inline JSON or a file                                                                
sb-cli user create <json>     Creates a user from inline JSON or a file                                                                
sb-cli user describe <email>  Describes a user for the given email                                                                     
sb-cli user list              Lists all available user                                                                                 
sb-cli user delete <email>    Deletes a user for the given email                                                                     

role

View roles and permissions

sb-cli role list  Lists all available roles

export

Export your data

sb-cli export status <Id>  Check the status of a data export task                                                                      
sb-cli export download     Generate download link to latest data export                                                                

intent

Create and manage intents

sb-cli intent import <utterances> <actions>   Begin import of intents for a bot                                                        
sb-cli intent create <json>                   Creates a intent from inline JSON or a file path                                         
sb-cli intent update <json>                   Updates an intent from inline JSON or a file                                             
sb-cli intent describe <bot> <alias>          Describes an intent                                                                   
sb-cli intent delete <bot> <alias> <version>  Deletes a particular intent                                                              
sb-cli intent list <bot>                      Get a list of intents for a bot                                                          
sb-cli intent export <bot>                    exports the intents for the given bot.                                                

job

Check Job Statuses

sb-cli job status <srn>  Gets the status of a job                                                                                   

missed-input

Monitor missed-input

sb-cli missed-input export  Exports missed input                                                                                       

logs

Watch logs

sb-cli logs watch  Watches logs for your organization                                                                                  

auth-profile

Setup and manage auth profiles

sb-cli auth-profile create <json>             Creates an auth profile from inline JSON or a file path                                  
sb-cli auth-profile describe <alias>          Describes an auth profile from the given alias                                        
sb-cli auth-profile list <limit> [nextToken]  Lists auth profiles, limited to the supplied limit and paginated by the supplied token   
sb-cli auth-profile delete <alias>            Deletes an auth profile with the given alias                                           
sb-cli auth-profile update <json>             Updates an auth profile with the given alias from inline JSON or a file path