AI.Feature43
This release note is written in English and Portuguese, scroll to the end to access both languages.
Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.
What is Error Management in QuickCommands and its benefits?
Error Management in QuickCommands is a new feature in StackSpot AI that allows content creators to handle exceptions directly within the flow of QuickCommands. With this update, you can now configure error control options for any step that uses agents or prompts, enabling you to decide what should happen if an error occurs—such as retrying a step or connecting to an alternate step. This enhancement increases the robustness and flexibility of your automations, minimizes unnecessary interruptions, and reduces the need for external webhooks for error handling.
Benefits:
- Greater control over QuickCommand execution flow.
- Ability to handle exceptions gracefully without workflow interruption.
- More robust and flexible automations.
- Improved user experience for content creators and end users.
How It Works
- Error Management Option: Each step in a QuickCommand that uses agents or prompts now includes a "Continue on error" setting.
- Custom Error Handling: When enabled, the creator can define specific actions for both success and error outcomes, such as:
- Connect to an alternative step or path.
- Display custom error messages using Jinja variables.
- Visual Configuration: The QuickCommand creation interface now features a clear section for setting up error handling rules.
- Usability: This option is available only for Prompt steps (not for Web Request steps) and is accessible via the step configuration panel.
- Documentation & Guidance: Updated documentation and visual aids (images, GIFs) are available to help users configure and utilize error management in their QuickCommands.
Implementation
- Access QuickCommands: Go to the StackSpot AI Portal and create or edit a QuickCommand.
- Configure Steps: For any step using an agent or prompt, toggle the "Continue on error" option.
- Define Flows: Assign actions for both Success and Error outcomes by connecting the step to subsequent actions as needed.
- Finalize & Test: Save your QuickCommand and test the error flows to ensure expected behavior.
- Documentation: Refer to the updated QuickCommands documentation for step-by-step guidance and examples.
User Journeys
- Via StackSpot AI Portal: Creators can visually configure error handling for each prompt/agent step, enhancing flow control directly from the UI.
- Via IDE Extension: When executing QuickCommands, the system will automatically handle errors according to the configured rules, providing a seamless experience.
- CLI: QuickCommands executed from the CLI will also respect the new error handling logic defined during configuration.
Gestão de Erro em QuickCommands e seus benefícios
A Gestão de Erro em QuickCommands é uma nova funcionalidade da StackSpot AI que permite aos criadores de conteúdo tratarem exceções diretamente no fluxo dos QuickCommands. Com esta atualização, agora é possível configurar opções de controle de erro em qualquer etapa que utilize agentes ou prompts, definindo o que deve acontecer caso um erro ocorra — como refazer um passo ou conectar a outro. Esse aprimoramento aumenta a robustez e flexibilidade das automações, minimiza interrupções desnecessárias e reduz a dependência de webhooks externos para tratamento de erros.
Benefícios:
- Maior controle sobre o fluxo de execução dos QuickCommands.
- Capacidade de tratar exceções sem interromper o fluxo.
- Automações mais robustas e flexíveis.
- Experiência aprimorada para criadores de conteúdo e usuários finais.
Como Funciona
- Opção de Gestão de Erro: Cada etapa de QuickCommand que utiliza agentes ou prompts agora conta com a configuração “Continuar em caso de erro”.
- Tratamento Personalizado: Ao habilitar a opção, o criador pode definir ações específicas para os resultados de sucesso e erro, como:
- Conectar a um passo alternativo ou caminho diferente.
- Exibir mensagens de erro personalizadas usando variáveis Jinja.
- Configuração Visual: A interface de criação de QuickCommand agora inclui uma seção clara para definir as regras de tratamento de erro.
- Usabilidade: Disponível apenas para etapas de Prompt (não para Web Request) e acessível pelo painel de configuração do passo.
- Documentação e Guias: A documentação foi atualizada e inclui recursos visuais (imagens, GIFs) para auxiliar na configuração e uso.
Implementação
- Acesse os QuickCommands: Entre no Portal da StackSpot AI e crie ou edite um QuickCommand.
- Configure os Passos: Para qualquer passo que utilize agente ou prompt, habilite a opção “Continuar em caso de erro”.
- Defina os Fluxos: Atribua ações para os resultados de Sucesso e Erro conectando o passo a outras etapas conforme necessário.
- Finalização e Teste: Salve seu QuickCommand e teste os fluxos de erro para garantir o comportamento esperado.
- Documentação: Consulte a documentação atualizada de QuickCommands para orientações detalhadas e exemplos.
Jornada do Usuário
- Pelo Portal StackSpot AI: O criador pode configurar visualmente o tratamento de erro para cada etapa de prompt/agente, aprimorando o controle do fluxo de execução diretamente na interface.
- Via Extensão de IDE: Na execução dos QuickCommands, o sistema seguirá automaticamente as regras de tratamento de erro configuradas, garantindo fluidez.
