O Criador de aplicativos usa o processamento de linguagem natural (PLN) para interpretar as solicitações do usuário e transformá-las em componentes de aplicativo acionáveis. Para maximizar a eficácia desta ferramenta, é importante fornecer solicitações claras e precisas. Este artigo descreve as principais diretrizes para criar solicitações eficazes que comuniquem suas necessidades com clareza ao Criador de aplicativos. Inclui também alguns exemplos de como usar a estrutura de solicitações do Criador de aplicativos para ajudar você a definir melhor o seu objetivo.
Seguindo essas diretrizes e o exemplo de estrutura, você pode garantir que o LLM entenda suas solicitações com precisão, resultando em um processo de desenvolvimento de aplicativos mais tranquilo e com melhores resultados.
Práticas recomendadas para solicitações eficazes
Seguir estas práticas recomendadas ajuda você a minimizar o número de solicitações necessárias, gerando resultados mais precisos e eficientes no Criador de aplicativos.
- Foque nas solicitações ao criar seu aplicativo: o Criador de aplicativos foi otimizado para ajudar você a projetar e aprimorar seus aplicativos, conectar APIs e configurar integrações. Oferece assistência de alto nível para a construção de aplicativos, mas não substitui as instruções de configuração passo a passo. Para tarefas específicas, como encontrar credenciais de API ou conectar sistemas de terceiros via chave de API ou OAuth, use a documentação oficial ou recursos confiáveis, como a Pesquisa Google ou o ChatGPT. Isso libera as solicitações do seu Criador de aplicativos para a lógica real do aplicativo e a criação de recursos.
- Saiba quando procurar ajuda adicional: se você já tentou solucionar o mesmo erro várias vezes (por exemplo, após três ou quatro tentativas de solicitação) e ainda não conseguiu prosseguir, entre em contato com o Suporte ao cliente Zendesk e informe os detalhes do erro.
- Descreva claramente os erros e as expectativas: quando seu aplicativo encontrar um erro durante os testes, explique exatamente o que deu errado e o que você esperava que acontecesse. O feedback detalhado ajuda a IA a resolver o problema com mais eficiência.
- Compartilhe detalhes de depuração para problemas não resolvidos: se as correções repetidas não forem bem-sucedidas, indique isso claramente na sua mensagem. Peça à IA para gerar informações detalhadas de depuração no console, depois reproduza o erro e cole a saída de volta na conversa.
- Agrupe alterações cosméticas e simples em lote: para otimizar o uso das solicitações, agrupe ajustes menores (como alterações de disposição, estilos de botão ou ordem das abas) em uma única solicitação, em vez de enviar várias solicitações separadas.
- Personalize o modo de teste com a pesquisa de tickets: use a pesquisa de tickets no Espaço de trabalho do agente para alterar tickets enquanto testa seu aplicativo. Isso permite uma validação rápida de cenários sem solicitações adicionais.
- Forneça exemplos de APIs privadas ou desconhecidas: se você estiver usando uma API que o Criador de aplicativos não reconhece, inclua uma solicitação de API de exemplo e a resposta esperada. Isso melhora a precisão da IA e reduz iterações desperdiçadas.
- Teste nos modos claro e escuro: se algum agente usa o modo escuro, certifique-se de testar seu aplicativo em ambos os temas para identificar e resolver problemas visuais o quanto antes.
-
Salve seu mapa antes de apagar conversas: antes de apagar uma conversa, salve o arquivo
blueprint.mdna aba Código. Ele tem um resumo do design do seu aplicativo e é importante para revisões futuras. - Ajuste o nome e o ícone do aplicativo em Configurações: atualize o nome e o ícone do aplicativo diretamente na aba Configurações, em vez de usar as solicitações.
- Os aplicativos são executados dentro do Espaço de trabalho do agente: os aplicativos do Criador de aplicativos operam dentro do ambiente do Espaço de trabalho do agente e são executados somente enquanto esse espaço de trabalho está aberto. Se você precisar de fluxos de trabalho em segundo plano ou persistentes, use o Criador de ações, o ZIS ou ferramentas externas, como Workato, Zapier, AWS Lambda ou Heroku.
- Planeje os requisitos antes de criar: antes de começar, defina o objetivo, o fluxo de trabalho, os requisitos de dados e as preferências do seu aplicativo. Isso ajuda a IA a fornecer uma primeira versão robusta e, muitas vezes, resulta em uma compilação mais rápida do que abrir um ticket de suporte.
Diretrizes para solicitações do Criador de aplicativos
As práticas recomendadas para escrever solicitações ao usar o Criador de aplicativos Zendesk incluem:
-
Use linguagem clara e simples
- Escreva solicitações em frases naturais e diretas, como se estivesse explicando suas necessidades a um colega.
- Evite jargões técnicos ou termos de programação que você não explique ou que os usuários não conheçam.
- Seja direto sobre o que o aplicativo deve fazer.
-
Seja específico sobre a funcionalidade desejada
- Indique claramente quais fontes de dados o aplicativo deve usar (por exemplo, Google, Jira, banco de dados interno).
- Especifique os principais recursos ou ações que o aplicativo deve ter (como exibir o status do pedido, enviar formulário de transferência).
- Inclua quaisquer pontos de dados ou resultados críticos que você queira que fiquem visíveis.
-
Inclua o contexto ou a função do usuário
Isso ajuda o Criador de aplicativos a personalizar a interface e a funcionalidade de acordo com as necessidades.
- Mencione os principais usuários do aplicativo (por exemplo, agentes, supervisores).
- Descreva o contexto em que eles usarão o aplicativo (por exemplo, ao gerenciar tickets de suporte).
-
Divida solicitações complexas
Isso reduz erros e ajuda você a entender melhor cada recurso.
- Se o aplicativo precisar de diversas funções, tente dividir as solicitações em partes menores e crie iterativamente.
- Comece com uma solicitação básica do aplicativo e, em seguida, refine-a adicionando recursos ou detalhes passo a passo.
-
Use exemplos e expectativas visuais
- Se possível, descreva como você deseja que a saída do aplicativo seja exibida (lista, botão, gráfico).
- Fazer referência a elementos tangíveis ajuda o criador a criar interfaces intuitivas.
-
Solicite melhorias iterativas
Um ciclo iterativo permite testar e aprimorar o aplicativo um recurso de cada vez, em vez de todos de uma só vez, resultando em aplicativos finais melhores sem codificação.
- Após a geração da primeira versão, revise e forneça feedback: o que funciona e o que não funciona.
- Use linguagem natural para especificar as alterações (por exemplo, “Adicionar um botão para atualizar os dados” ou “Mostrar apenas os tickets abertos”).
-
Foque nos benefícios práticos
Isso mantém o aplicativo focado em agregar valor, o que garante relevância e usabilidade.
- Estruture as solicitações em torno dos problemas a serem resolvidos ou das tarefas a serem simplificadas para os agentes.
-
Evite ambiguidade
- Não use termos vagos como “mostrar informações relevantes” sem explicar o que significa “relevante”.
- A ambiguidade pode levar a aplicativos que não atendem às suas expectativas.
Seguindo essas práticas recomendadas, usuários sem experiência em codificação podem escrever solicitações eficazes para criar aplicativos de suporte personalizados e úteis.
Estrutura para solicitações do Criador de aplicativos
Ao escrever uma solicitação, você está dando instruções ao Criador de aplicativos de uma maneira semelhante a dar instruções a um desenvolvedor para criar um aplicativo para você. É útil ter um plano para o que você deseja realizar. A estrutura a seguir permite que você e o Criador de aplicativos saibam o que esperar, ajudando você a se concentrar com mais eficiência no seu objetivo.
Sem esse tipo de orientação, o Criador de aplicativos criará um aplicativo, mas ele poderá não atender às suas necessidades. O Criador de aplicativos tenta, mesmo que sua solicitação seja Criar um aplicativo. No entanto, se você precisar de um aplicativo específico, quanto mais você orientar o Criador de aplicativos, maior será a probabilidade de obter o que precisa.
Ao escrever as solicitações, leve em consideração estes princípios MAPS: Missão, Ação, Partes, Escopo
- Missão: qual é a função do aplicativo. Considere a necessidade e o contexto atuais.
- Ação: o que a IA deve gerar. Considere as funcionalidades e os fluxos de trabalho principais.
- Partes: quais são as partes da interface do usuário ou estruturais. Considere os componentes de aparência e funcionalidade.
- Escopo: para quem ou para quê serve. Considere as restrições e o público-alvo.
Ao usar os princípios MAPS, se você não tiver certeza ou não gostar de algo, poderá alterar a ação, o escopo ou as partes sem alterar as outras seções.
Exemplos de solicitações, usando os princípios MAPS
Veja a seguir alguns exemplos de solicitação que usam os princípios MAPS:
Exemplo 1: aplicativo My Recent Satisfaction Comments
- Missão: esse aplicativo foi desenvolvido para a satisfação dos agentes e permite um ciclo de feedback para que eles tenham uma visão do histórico de satisfação do cliente, orientando as interações e melhorando a qualidade do serviço.
- Ação: criar um aplicativo de painel lateral que recupere e mostre os cinco comentários de satisfação de ticket mais recentes e as tendências dos últimos seis meses.
- Partes: não exiba a data e o score de satisfação. Exiba os cinco comentários de satisfação de ticket mais recentes em uma tabela e as tendências de 6 meses em um gráfico de linhas compacto. Inclua abas para alternar entre comentários individuais de satisfação de ticket e tendências. Faça com que a coluna de comentários ocupe toda a largura do aplicativo. Aplique um tom leve e desbotado de verde ao fundo de cada contêiner se o índice de satisfação foi bom, e um tom leve e desbotado de vermelho se foi ruim.
-
Escopo: esse aplicativo é para agentes que visualizam tickets de suporte. Exiba os comentários de satisfação do ticket apenas para o solicitante atual e somente tickets com a mesma marca ou organização.
Exemplo 2: aplicativo Customer 360
- Missão: esse aplicativo foi desenvolvido para aumentar a eficiência dos agentes, exibindo informações importantes do cliente diretamente na visualização do ticket, proporcionando aos agentes acesso rápido aos detalhes de que precisam para resolver problemas sem precisar sair da tela.
- Ação: crie um aplicativo que recupere e exiba informações do cliente, histórico de compras e informações de fidelidade do cliente de nosso banco de dados CRM interno.
- Partes: exiba informações do cliente, histórico de compras e informações de fidelidade do cliente em três abas separadas. Indique visualmente a aba que está sendo visualizada no momento. Destaque em amarelo as informações que indicam baixa fidelidade do cliente. Adicione um botão para atualizar os dados exibidos e refletir as alterações mais recentes.
-
Escopo: esse aplicativo é para agentes que visualizam tickets de suporte. Exiba essas informações apenas para o solicitante atual e somente para os tickets com a mesma marca ou organização.
Exemplos de aplicativos criados pelo cliente
Veja a seguir alguns exemplos de aplicativos criados por clientes da Zendesk:
Aplicativo Assignee Change Tracket: registra todas as alterações de atribuição de tickets em uma tabela e exibe o número total de atribuições de tickets que ocorreram. Está disponível para uso por administradores e leads de equipes. Um administrador levou menos de 30 minutos para criar esse aplicativo.
Solicitações
- Crie um aplicativo que monitore as alterações em um atribuído em um determinado ticket. Certifique-se de exibir nomes de atribuído de atribuídos anteriores e dos novos atribuídos. Exiba também o número total de alterações na atribuição do ticket.
- Adicione um botão para atualizar os dados exibidos e refletir as alterações mais recentes. Adicione outro botão para exportar dados para o Excel. Crie os dois botões em tamanhos pequenos e coloque-os lado a lado.
Aplicativo resultante
Aplicativo My Recent Satisfaction Comments: exibe os cinco comentários de CSAT mais recentes em um ticket. Eles pretendem usar este aplicativo como substituto para os comentários de CSAT que costumavam ser exibidos na parte superior do ticket, os quais foram removidos do registro de conversas quando atualizaram para a versão mais recente da ferramenta de CSAT incorporada do Zendesk. Um administrador levou uma hora para criar este aplicativo e implantá-lo para produção. Esse aplicativo foi desenvolvido para a satisfação dos agentes e permite um ciclo de feedback para que eles saibam como os clientes se sentem após cada interação.
Solicitações
- Crie um aplicativo que mostre os cinco comentários de satisfação de ticket mais recentes.
- Atualize o aplicativo para mostrar apenas os comentários de satisfação do ticket para o usuário atual.
- O aplicativo ainda está mostrando os cinco comentários mais recentes de satisfação do ticket, considerando todos os usuários, não apenas o usuário atual.
- Remova as colunas de data e score. E faça com que a coluna de comentários ocupe toda a largura do aplicativo.
- Aplique um tom leve e desbotado de verde ao fundo de cada contêiner se o índice de satisfação foi bom, e um tom leve e desbotado de vermelho se foi ruim.
Aplicativo resultante
Aplicativo User Data: exibe os dados do ticket do solicitante, o histórico completo do ticket e os anexos do ticket.
Solicitações
- Crie um relatório do Conhecimento ou do Explore com os dados dos tickets do usuário, incluindo a data de criação, a data de fechamento e o ID do ticket. O botão do relatório deve primeiro criar o relatório e, em seguida, configurá-lo para download.
- Veja o histórico de tickets do cliente, em que todos os status dos tickets são exibidos na ordem: Novo>Aberto>Pendente>Resolvido>Fechado.
- Baixe todos os arquivos enviados como anexos no ticket.
Aplicativo resultante
Aplicativo My Insights: permite que os agentes visualizem os cinco principais tópicos ou categorias dos tickets que eles resolveram nos últimos seis meses.
Solicitações
- Crie um aplicativo para que o agente veja os cinco principais tópicos ou categorias em que ele resolveu tickets nos últimos seis meses, com base no número de tickets nos últimos seis meses, bem como com base no número de tickets por formulários de ticket e qual é o CSAT para cada um. Faça com que os nomes das categorias reflitam um caso de uso de e-commerce e varejo B2C e apenas crie dados fictícios. Não deve haver scores de CSAT de N/A% ou 100% Adicione uma coluna para TMA e para Tempo médio de resolução total.
- Adicione um filtro que permita ao agente analisar detalhadamente os dados por período e também adicionar uma contagem de atribuídos do agente a cada categoria.
- As reatribuições devem ser calculadas pela média, e não pelo número total, dentro de cada categoria. Além disso, adicione uma coluna de como o tempo médio de resolução é comparado ao benchmark da equipe usando a tag do sistema de cores do semáforo, ou seja, verde, amarelo e vermelho.
Aplicativo resultante
Aplicativo User & Org Details: exibe detalhes do usuário e da organização, incluindo campos de usuário personalizados e campos de organização personalizados com seções recolhíveis.
Solicitações
- Crie um aplicativo que mostre detalhes do usuário e da organização, incluindo todos os campos de usuário e da organização personalizados.
- Obrigado. Você pode obter o nome dos campos de usuário e da organização personalizados, em vez da chave? Além disso, vamos renomear o aplicativo User & Org Details.
Aplicativo resultante
Aplicativo Ticket Pulse: exibe a atividade recente do solicitante, especificamente os cinco tickets mais recentes com suas informações associadas.
Solicitações
- Crie um aplicativo que exiba os cinco tickets mais recentes do solicitante atual do ticket. Quero exibir o número do ticket, o assunto e um link que redirecione para abri-lo em uma nova aba.
- É possível abrir um ticket em uma nova aba dentro do Zendesk?
- Você pode tornar a interface do usuário mais fácil de usar?
- Forneça um nome mais legal.
Aplicativo resultante
Aplicativo Salesforce Account Details: exibe os detalhes da conta do Salesforce do solicitante do ticket.
Solicitações
- Use a API do Zendesk para acessar a API do Salesforce e recuperar os detalhes da conta do Salesforce do solicitante do ticket.
- Agora, para fins de teste e para mostrar como o aplicativo ficaria, faça com que ele retorne valores de teste fictícios para cada um dos campos do Salesforce sem realmente acessar a API do Salesforce.
Aplicativo resultante
Recursos adicionais
- Pesquisar todas as receitas do Criador de aplicativos: uma coleção de exemplos de aplicativos criados pela comunidade para inspirar seu próximo projeto.
- Criar uma receita de aplicativo: compartilhe suas criações do Criador de aplicativos com a comunidade enviando uma publicação de receita. Consulte as instruções completas para começar.