Você pode ter uma API que pode aceitar vários parâmetros de solicitação, mas nem todos são obrigatórios para fazer uma chamada bem-sucedida. Se um parâmetro é esperado, mas não fornecido, a integração pode falhar porque a API espera um valor válido — seja uma cadeia de caracteres vazia `””` ou `null`. Nesse caso, será necessário anular esses parâmetros no criador de integrações para que a chamada não seja interrompida.
Como anular parâmetros opcionais
- Entenda o comportamento do parâmetro opcional.
Primeiro, certifique-se de que sua API consiga lidar adequadamente com valores opcionais, seja como uma cadeia de caracteres vazia ou como `null`. - Quando um chat for iniciado, inicialize os parâmetros opcionais como nulos ou como uma cadeia de caracteres vazia.
Isso impedirá a falha da chamada da API quando um parâmetro for omitido. Para obter mais informações, consulte Sobre as ações para agentes de IA.
- Na integração especificada no criador de integrações, verifique se os parâmetros são coletados como parâmetros de solicitação e se a caixa de seleção Obrigatório está desmarcada.
- Passe o cursor do mouse sobre a caixa de entrada Testar valor até você vir o símbolo de reformatação de valores.
Ao clicar nesse símbolo, uma caixa de diálogo é exibida. Aqui, você deseja adicionar a expressão JSONata a seguir à caixa de texto “Reformatação do JSONata”:
```$a and $not($a = "null") ? $a : ""```
Essa expressão JSONata verificará se o parâmetro existe e tem um valor.- Se sim, passe o valor do parâmetro para a API.
- Se não, forneça uma cadeia de caracteres vazia ou omita-o completamente.
Para obter mais informações sobre como reformatar valores, consulte Reformatação de valores em parâmetros de solicitação para agentes de IA.
Agora, quando você tiver um valor que seja opcional para sua chamada da API, ele será tratado pelo criador de integrações de maneira transparente.