Os agentes pré-criados são um conjunto de agentes fornecidos pelos agentes de conversação (Dialogflow CX) para casos de uso comuns. Esses agentes podem ser usados como uma base para a criação de conversas. Nos agentes de conversação (Dialogflow CX), você encontra casos de uso comuns de todos os setores, como telecomunicações, serviços financeiros, saúde, varejo e viagens. Os agentes pré-criados generativos também estão disponíveis com acesso limitado, demonstrando casos de uso comuns implementados usando recursos generativos.
Os agentes pré-criados incluem intents e entidades para os casos de uso, mas você precisa modificar os grupos de rota e fulfillment (quando aplicável).
Limitações
Considere as seguintes limitações:
- Atualmente, os agentes pré-criados só estão disponíveis em inglês (en).
Importar um agente pré-criado
Se você quiser importar um agente pré-criado para seu projeto, siga estas etapas:
- Acesse o console do Dialogflow CX.
- Clique no projeto em que você quer importar o agente pré-criado.
- Clique em Usar agentes predefinidos.
- Clique no agente de interesse e em Importar.
- Escolha o local e clique em Criar.
- Comece a testar e personalizar.
Personalizar o agente pré-criado importado
- Teste o agente usando o simulador para entender o que ele pode ajudar os usuários a realizar.
- Clique na guia Gerenciar no painel esquerdo e em Casos de teste para ver a cobertura e os scripts de exemplo. Para mais informações, consulte a documentação dos Casos de teste.
- Exclua todos os fluxos irrelevantes para seu caso de uso.
- Edite o diálogo do agente e as entidades personalizadas para atender às necessidades da sua empresa.
- Se houver código-fonte do webhook, consulte Como modificar o código do webhook.
Como modificar o código do webhook
Uma seleção dos agentes pré-criados utiliza webhooks. O código-fonte do webhook original usa o Node.js e está hospedado no projeto interno do Cloud Functions do Google.
Para usar e modificar esse código no seu próprio projeto do Cloud Functions, siga as instruções a seguir:
- Acesse o console do Dialogflow CX.
- Clique no projeto em que você quer importar o agente pré-criado.
- Clique em Usar agentes predefinidos.
Clique no agente de interesse e depois em Link de documentação, que o levará para a seção de agente pré-criada deste documento.
Consulte a subseção Webhook para o agente pré-criado e copie o código-fonte.
Acesse o console do Google Cloud e selecione Cloud Functions no painel à esquerda.
Clique no projeto para o qual você quer importar o código-fonte.
Clique em Criar função. Para mais instruções, consulte a documentação Criar uma função do Cloud Function.
Na seção Código-fonte, selecione Editor in-line e cole o código-fonte copiado.
Clique em Origem e Editar para alterar a lógica com base nas suas regras de negócios. Quando terminar, clique em Implantar.
Clique em Acionador e copie o URL do acionador.
Substitua o URL do acionador no seu agente em Gerenciar > Webhooks e selecionando o webhook para colar o novo URL. Cole o URL do acionador no campo "URL do webhook". Clique em Salvar.
Usando a documentação do Webhooks, teste o fulfillment.
Agente de serviços financeiros
Esse modelo ajuda os usuários finais com cartões, verifica o status de uma inscrição e investiga cobranças suspeitas.
Exemplos de declarações
- Quero efetuar um pagamento no meu saldo.
- Perdi meu cartão e preciso de um novo.
- Quero denunciar atividades suspeitas na minha conta corrente.
- Qual é o status da minha inscrição de empréstimo automático?
- Quais são as diferentes taxas anuais nos seus cartões de crédito empresariais?
Webhook
O webhook do Cloud Functions executa as seguintes ações:
- Valida a identidade de um usuário final
- Fornece amostras de saldos, status de empréstimo e informações de recursos de cartões de crédito
- Simula os pagamentos de amostra, incluindo a validação de valores e datas de pagamentos
- Controla o horário de funcionamento
package.json
{
"name": "sample-http",
"version": "0.0.1"
}
index.js
/** * Responds to any HTTP request. * * @param {!express:Request} req HTTP request context. * @param {!express:Response} res HTTP response context. */ exports.cxPrebuiltAgentsFinServ = (req, res) => { console.log('Cloud Function:', 'Invoked cloud function from Conversational Agents (Dialogflow CX)'); let tag = req.body.fulfillmentInfo.tag; if (!!tag) { switch (tag) { // BEGIN validateAccount case 'validateAccount': console.log(tag + ' was triggered.'); let card_last_four = req.body.sessionInfo.parameters.card_last_four; let card_verified; // card validation only fails if card number is 0000 if (card_last_four == '0000') { card_verified = 'false'; } else { card_verified = 'true'; } res.status(200).send( {sessionInfo: {parameters: {card_verified: card_verified}}}); console.log(' verified: ' + card_verified); break; // BEGIN getAccountInfo case 'getAccountInfo': console.log(tag + ' was triggered.'); let current_balance; let last_statement_balance; let minimum_due; // Random current balance between 1 and 1000 current_balance = Math.floor(Math.random() * 1000); // Last statement balance is 70% of current balance last_statement_balance = Math.floor(current_balance * 0.7); // Minimum due is 25% of last statement balance minimum_due = Math.floor(last_statement_balance * 0.25); res.status(200).send({ sessionInfo: { parameters: { current_balance: current_balance, last_statement_balance: last_statement_balance, minimum_due: minimum_due } } }); console.log( 'current balance: ' + current_balance + ' last statement balance: ' + last_statement_balance); break; // BEGIN getPaymentSource case 'getPaymentSource': console.log(tag + ' was triggered.'); // static array of account names let account_names = ['National Checking Account', 'My Checking', 'Personal Checking']; // random array value for account names let account_index = Math.floor(Math.random() * account_names.length); let selected_account = account_names[account_index]; res.status(200).send( {sessionInfo: {parameters: {selected_account: selected_account}}}); console.log(' selected account: ' + selected_account); break; // BEGIN submitPayment case 'submitPayment': console.log(tag + ' was triggered.'); let card_digits = String(req.body.sessionInfo.parameters.card_last_four); let payment_status; // When first digit of card_digits is 9 the transaction fails if (card_digits[0] == '9') { payment_status = 'fail'; } else { payment_status = 'success'; } res.status(200).send( {sessionInfo: {parameters: {payment_status: payment_status}}}); console.log(' verified: ' + card_verified); break; // BEGIN validatePaymentAmount case 'validatePaymentAmount': console.log(tag + ' was triggered.'); // get payment amount let payment_amount = Number(req.body.sessionInfo.parameters.other_amount); let current_balance_temp = req.body.sessionInfo.parameters.current_balance; let amount_valid; payment_amount = Number(payment_amount); console.log( `payment_amount: ` + payment_amount + ` current balance: ` + current_balance_temp); // confirm payment amount is a positive value less than or equal to the // current balance if (payment_amount > 0) { if (payment_amount <= current_balance_temp) { amount_valid = true; } else { amount_valid = false; } } else { amount_valid = false; } res.status(200).send( {sessionInfo: {parameters: {amount_valid: amount_valid}}}); console.log('payment status: ' + payment_status); break; // BEGIN validatePaymentDate case 'validatePaymentDate': console.log(tag + ' was triggered.'); // get payment date let payment_date_raw = req.body.sessionInfo.parameters.payment_date; // set payment date in date object format. subtract one from month // because month is indexed to 0. let payment_year = payment_date_raw.year; let payment_month = payment_date_raw.month - 1; let payment_day = payment_date_raw.day; console.log( 'Payment - Year: ' + payment_year + ' Month ' + payment_month + ' Day: ' + payment_day); // set today's date let today = new Date(); let this_year = today.getFullYear(); let this_month = today.getMonth(); let this_day = today.getDate(); console.log( 'Today - Year: ' + this_year + ' Month ' + this_month + ' Day: ' + this_day); let payment_date_valid; // check if the payment date is after today if (payment_year > this_year) { payment_date_valid = true; console.log('Future year'); } else if (payment_year == this_year && payment_month > this_month) { payment_date_valid = true; console.log('Future month'); } else if ( payment_year == this_year && payment_month == this_month && payment_day >= this_day) { payment_date_valid = true; console.log('Today or later this month'); } else { payment_date_valid = false; } res.status(200).send({ sessionInfo: {parameters: {payment_date_valid: payment_date_valid}} }); console.log('payment date valid: ' + payment_date_valid); break; // BEGIN checkInHours case 'checkInHours': console.log(tag + ' was triggered.'); // check if we are currently in hours let currentDate = new Date(); console.log('current time is ' + currentDate); let currentHour = currentDate.getHours(); console.log('current hour is ' + currentHour); if (currentHour >= 8 && currentHour <= 20) { in_hours = 'true'; console.log('currently in hours'); } else { in_hours = 'false'; console.log('currently out of hours'); } res.status(200).send({sessionInfo: {parameters: {in_hours: in_hours}}}); break; // BEGIN getRetryCount case 'getRetryCount': console.log(tag + ' was triggered.'); // increment the current retry counter let retry_count = req.body.sessionInfo.parameters.retry_count; retry_count = retry_count + 1; res.status(200).send( {sessionInfo: {parameters: {retry_count: retry_count}}}); break; // BEGIN getLoanStatus case 'getLoanStatus': console.log(tag + ' was triggered.'); let loan_reference = String(req.body.sessionInfo.parameters.loan_reference); let loan_type = loan_reference[0]; let loan_status = loan_reference[1]; let loan_found = 'true'; console.log('loan ref is ' + loan_reference); console.log('type is ' + loan_type); console.log('status is ' + loan_status); // mock loan not found if (loan_reference[0] == '0') { loan_found = 'false'; } // mock loan found if ((loan_type != 'auto') && (loan_type != 'home')) { if (loan_reference[0] > '5') { loan_type = 'home'; } else { loan_type = 'auto'; } } res.status(200).send({ sessionInfo: { parameters: { loan_type: loan_type, loan_status: loan_status, loan_found: loan_found } } }); break; // BEGIN validateTransactionDate case 'validateTransactionDate': console.log(tag + ' was triggered.'); // get date queried let date_queried_raw = req.body.sessionInfo.parameters.date_queried; // set date queried in date object format. subtract one from month // because month is indexed to 0. date_queried = new Date( date_queried_raw.year, date_queried_raw.month - 1, date_queried_raw.day); console.log(date_queried + ' is the date im looking for.'); let date_valid; let date_now = new Date(); // check if the payment date is after today if (date_queried > date_now) { date_valid = 'false'; } else { date_valid = 'true'; } res.status(200).send( {sessionInfo: {parameters: {date_valid: date_valid}}}); break; // BEGIN lookupTransactions case 'lookupTransactions': console.log(tag + ' was triggered.'); // select a random retailer from the retailers array let retailers = [ 'Dior', 'Walmart', 'Target', 'Costco', 'Macy\'s', 'Bed Bath & Beyond', 'Amazon', 'Walgreens', 'Home Depot', 'Best Buy', 'Kohl\'s' ]; let randomRetail = Math.floor(Math.random() * retailers.length); console.log('random retail value ' + randomRetail); let retailer_queried = retailers[randomRetail]; // Alter the transaction amount let amount_queried = Number(req.body.sessionInfo.parameters.amount_queried.amount); let transaction_value = Number(amount_queried); let randomAdjust = Math.floor(Math.random() * 5); randomAdjust = Number(randomAdjust / 100); let adjustment = Number(amount_queried * randomAdjust); let randomMath = Math.floor(Math.random() * 1); if (randomMath < 1) { transaction_value = Number(transaction_value - adjustment).toFixed(2); } else if (randomMath = 1) { transaction_value = Number(transaction_value + adjustment).toFixed(2); } if (amount_queried < 1000) { transaction_found = 'true'; } else { transaction_found = 'false'; } res.status(200).send({ sessionInfo: { parameters: { retailer_queried: retailer_queried, transaction_value: transaction_value, transaction_found: transaction_found } } }); break; // BEGIN lookupCardFeatures case 'lookupCardFeatures': console.log(tag + ' was triggered.'); // setup arrays for card features let interestRate = [ '14.5% APR', '0% APR in year 1 and then increases to 25% APR in year 2', '10% APR in year 1 and then increases to 20% APR in year 2', '18% APR' ]; let annualFee = [ '$0 annual fee for year 1 and then increases to $90 in year 2', '$70 annual fee starting in year 1', '$15 annual fee for year 1 and then increases to $80 in year 2', '$50 annual fee starting in year 1' ]; let cashBackRate = ['1%', '3%', '6%', '2%', '5%', '4%']; let pointsBonus = ['50,000', '25,000', '10,000', '100,000', '75,000']; // setup card one features let cardOneRandomInterest = Math.floor(Math.random() * interestRate.length); let card_one_interest = interestRate[cardOneRandomInterest]; let cardOneRandomFee = Math.floor(Math.random() * annualFee.length); let card_one_fee = annualFee[cardOneRandomFee]; let cardOneRandomCashback = Math.floor(Math.random() * cashBackRate.length); let card_one_cashback = cashBackRate[cardOneRandomCashback]; let cardOneRandomPoints = Math.floor(Math.random() * pointsBonus.length); let card_one_points = pointsBonus[cardOneRandomPoints]; // setup card two features let cardTwoRandomInterest = Math.floor(Math.random() * interestRate.length); let card_two_interest = interestRate[cardTwoRandomInterest]; let cardTwoRandomFee = Math.floor(Math.random() * annualFee.length); let card_two_fee = annualFee[cardTwoRandomFee]; let cardTwoRandomCashback = Math.floor(Math.random() * cashBackRate.length); let card_two_cashback = cashBackRate[cardTwoRandomCashback]; let cardTwoRandomPoints = Math.floor(Math.random() * pointsBonus.length); let card_two_points = pointsBonus[cardTwoRandomPoints]; res.status(200).send({ sessionInfo: { parameters: { card_one_interest: card_one_interest, card_one_fee: card_one_fee, card_one_cashback: card_one_cashback, card_one_points: card_one_points, card_two_interest: card_two_interest, card_two_fee: card_two_fee, card_two_cashback: card_two_cashback, card_two_points: card_two_points } } }); break; default: console.log('default case called'); res.status(200).end(); break; } } };
Agente de saúde
Este modelo ajuda os usuários finais a verificar declarações, benefícios e encontrar um médico.
Exemplos de declarações
- O que é cosseguro?
- Você pode me ajudar a encontrar um médico?
- Não estou me sentindo bem.
- Qual é minha franquia?
Agente de gerenciamento de pedidos e contas
Esse modelo ajuda os usuários finais a comprar ou devolver um produto, rastrear pedidos e gerenciar configurações da conta, como pontos de fidelidade, endereços e senhas.
Exemplos de declarações
- Não recebi meu pedido. Onde ele está?
- Quero comprar um novo smartphone.
- Esqueci a minha senha.
- Você pode me dizer quantos pontos eu tenho?
- Mudei e preciso atualizar meu endereço.
Agente de acordo com o pagamento
Esse modelo ajuda os usuários finais a configurar uma disposição de pagamento de duas parcelas ou estender uma data de vencimento.
Exemplos de declarações
- Minha conta foi suspensa.
- Não vou receber pagamentos em dia da minha conta.
- Preciso estender minha data de entrega.
- Perdi meu emprego devido à COVID-19.
Webhook
Este webhook do Cloud Functions executa as seguintes ações:
- Informa o valor de amostra devido e as datas máximas de extensão.
- Calcula a segunda parcela do pagamento com base na diferença entre o saldo total e a primeira parcela paga.
- Valida se a data de extensão solicitada não ultrapassa a data de extensão máxima.
package.json
{
"name": "sample-http",
"version": "0.0.1",
"dependencies": {
"moment": "2.27.0"
}
}
index.js
const moment = require('moment'); function getRandomAmount(min, max) { return Math.random() * (max - min) + min; } function formatCurrency(amount) { return Number(amount).toFixed(2); } function formatUserDate(dateObject) { if (!dateObject) { console.log('dateObject error. dateObject passed to formatUserDate is:', dateObject); console.log('dateObject requires day, month, year properties:'); // return false if the dates are not valid // returning false prevents the if/else block from running, which causes the function to crash. return false; } console.log('formatUserDate date set.'); const { day, year, month } = dateObject; return `${year}-${month}-${day}`; } /** * Responds to any HTTP request. * * @param {!express:Request} req HTTP request context. * @param {!express:Response} res HTTP response context. */ exports.cxPrebuiltAgentsPaymentArrangement = (req, res) => { var tag = req.body.fulfillmentInfo.tag; var first_payment; var amount_due_1; //var adjust_due_date; var max_date_1; var maxDate1; var max_date_2; var maxDate2; var current_due_date; var max_extension_date; var maxExtensionDate; var amount_due; var payment_amount_2; var dateFromUser; var valid_payment; var valid_date; if (!!tag) { switch (tag) { //Initialize Dynamic parameters case 'setDynamicParams': console.log(tag + ' was triggered.'); max_date_1 = moment().add(15, 'days').calendar(); max_date_2 = moment().add(25, 'days').calendar(); current_due_date = moment().add(10, 'days').calendar(); max_extension_date = moment().add(30, 'days').calendar(); amount_due = formatCurrency(getRandomAmount(200, 400)); res.status(200).send({ sessionInfo: { parameters: { max_date_1: max_date_1, max_date_2: max_date_2, current_due_date: current_due_date, max_extension_date: max_extension_date, amount_due: amount_due, } } }); break; //Initialize Static parameters case 'setStaticParams': console.log(tag + ' was triggered.'); user_id = req.body.sessionInfo.parameters.user_id; if (user_id == '1001') { max_date_1 = "2021-01-15"; max_date_2 = "2021-01-30"; current_due_date = "2021-01-01"; max_extension_date = "2021-02-15"; amount_due = '225.00'; } else if (user_id == '2002') { max_date_1 = "2021-03-15"; max_date_2 = "2021-03-30"; current_due_date = "2021-03-01"; max_extension_date = "2021-04-15"; amount_due = '333.00'; } else if (user_id == '3003') { max_date_1 = "2021-05-15"; max_date_2 = "2021-05-30"; current_due_date = "2021-05-01"; max_extension_date = "2021-06-15"; amount_due = '189.00'; } else { max_date_1 = moment().add(15, 'days').calendar(); max_date_2 = moment().add(25, 'days').calendar(); current_due_date = moment().add(10, 'days').calendar(); max_extension_date = moment().add(30, 'days').calendar(); amount_due = formatCurrency(getRandomAmount(200, 400)); } res.status(200).send({ sessionInfo: { parameters: { max_date_1: max_date_1, max_date_2: max_date_2, current_due_date: current_due_date, max_extension_date: max_extension_date, amount_due: formatCurrency(amount_due), } } }); break; //Automatically set second payment based on first payment amount case 'secondPayment': console.log(tag + ' was triggered.'); first_payment = req.body.sessionInfo.parameters.payment_amount_1.amount; amount_due_1 = req.body.sessionInfo.parameters.amount_due; payment_amount_2 = formatCurrency(amount_due_1 - formatCurrency(first_payment)); res.status(200).send({ sessionInfo: { parameters: { payment_amount_2: payment_amount_2 } } }); break; //BEGIN validatePayment case 'validatePayment': console.log(tag + ' was triggered.'); first_payment = req.body.sessionInfo.parameters.payment_amount_1.amount; amount_due_1 = req.body.sessionInfo.parameters.amount_due; if ((formatCurrency(first_payment) >= '100.00') && (formatCurrency(first_payment) < amount_due_1)) { valid_payment = "True"; } else { valid_payment = "False" } res.status(200).send({ sessionInfo: { parameters: { valid_payment: valid_payment, } } }); break; //BEGIN validateDate case 'validateDate': // Log when the cloud function for the validateDate tag is triggered console.log(tag + ' was triggered.'); // Log ALL of the session parameters passed to the cloud function console.log('validateDate sessionInfo parameters', req.body.sessionInfo.parameters); // Log ONLY max_extension_date and adjust_due_date values from session parameters. console.log('sessionInfo >>> max_extension_date', req.body.sessionInfo.parameters.max_extension_date); console.log('sessionInfo >>> adjust_due_date', req.body.sessionInfo.parameters.adjust_due_date); // If the formatUserDate function succeeds running, then the date will be a string formatted as yyyy-mm-dd. // If the session params dateObject is not formatted correctly the formatUserDate function returns the boolean value false. // formatUserDate returns false to prevent the Moment function from running (see 3 conditions below). dateFromUser = formatUserDate(req.body.sessionInfo.parameters.adjust_due_date); maxExtensionDate = req.body.sessionInfo.parameters.max_extension_date; // Set valid_date to false. We do this so the cloud function does not crash and always returns a value to Conversational Agents (Dialogflow CX) valid_date = "False" // Only set valid_date to true when // 1) dateFromUser is a date string and not set to false by the formatUserDate function // 2) maxExtensionDate is string and not set to false by the formatUserDate function // 3) if Moment determines the dateFromUser is before maxExtensionDate if (dateFromUser && maxExtensionDate && moment(dateFromUser).isSameOrBefore(maxExtensionDate)) { valid_date = "True"; } res.status(200).send({ sessionInfo: { parameters: { valid_date: valid_date, // You will see the debug property in the Conversational Agents (Dialogflow CX) UI // if formatUserDate failed for eitehr date you will // see 'false' in the UI. // Otherwise, you will see the string formatted date debug: {dateFromUser, maxExtensionDate} } } }); break; case 'validateDate1': // Log when the cloud function for the validateDate tag is triggered console.log(tag + ' was triggered.'); // Log ALL of the session parameters passed to the cloud function console.log('validateDate sessionInfo parameters', req.body.sessionInfo.parameters); // Log ONLY max_date_1 and payment_date_1 values from session parameters. console.log('sessionInfo >>> max_date_1', req.body.sessionInfo.parameters.max_date_1); console.log('sessionInfo >>> payment_date_1', req.body.sessionInfo.parameters.payment_date_1); // If the formatUserDate function succeeds running, then the date will be a string formatted as yyyy-mm-dd. // If the session params dateObject is not fomatted correctly the formatUserDate function returns the boolean value false. // formatUserDate returns false to prevent the Moment function from running (see 3 conditions below). dateFromUser = formatUserDate(req.body.sessionInfo.parameters.payment_date_1); //maxExtensionDate = formatUserDate(req.body.sessionInfo.parameters.max_extension_date); maxDate1 = req.body.sessionInfo.parameters.max_date_1; // Set valid_date to false. We do this so the cloud function does not crash and always returns a value to Conversational Agents (Dialogflow CX) valid_date = "False" // Only set valid_date to true when // 1) dateFromUser is a date string and not set to false by the formatUserDate function // 2) maxExtensionDate is string and not set to false by the formatUserDate function // 3) if Moment determines the dateFromUser is before maxExtensionDate if (dateFromUser && maxDate1 && moment(dateFromUser).isSameOrBefore(maxDate1)) { valid_date = "True"; } res.status(200).send({ sessionInfo: { parameters: { valid_date: valid_date, // You will see the debug property in the Conversational Agents (Dialogflow CX) UI // if formatUserDate failed for eitehr date you will // see 'false' in the UI. // Otherwise, you will see the string formatted date debug: {dateFromUser, maxDate1} } } }); break; case 'validateDate2': // Log when the cloud function for the validateDate tag is triggered console.log(tag + ' was triggered.'); // Log ALL of the session parameters passed to the cloud function console.log('validateDate sessionInfo parameters', req.body.sessionInfo.parameters); // Log ONLY max_date_2 and payment_date_2 values from session parameters. console.log('sessionInfo >>> max_extension_date', req.body.sessionInfo.parameters.max_date_2); console.log('sessionInfo >>> adjust_due_date', req.body.sessionInfo.parameters.payment_date_2); // If the formatUserDate function succeeds running, then the date will be a string formatted as yyyy-mm-dd. // If the session params dateObject is not fomatted correctly the formatUserDate function returns the boolean value false. // formatUserDate returns false to prevent the Moment function from running (see 3 conditions below). dateFromUser = formatUserDate(req.body.sessionInfo.parameters.payment_date_2); //maxExtensionDate = formatUserDate(req.body.sessionInfo.parameters.max_extension_date); maxDate2 = req.body.sessionInfo.parameters.max_date_2; // Set valid_date to false. We do this so the cloud function does not crash and always returns a value to Conversational Agents (Dialogflow CX) valid_date = "False" // Only set valid_date to true when // 1) dateFromUser is a date string and not set to false by the formatUserDate function // 2) maxExtensionDate is string and not set to false by the formatUserDate function // 3) if Moment determines the dateFromUser is before maxExtensionDate if (dateFromUser && maxDate2 && moment(dateFromUser).isSameOrBefore(maxDate2)) { valid_date = "True"; } res.status(200).send({ sessionInfo: { parameters: { valid_date: valid_date, // You will see the debug property in the Conversational Agents (Dialogflow CX) UI // if formatUserDate failed for eitehr date you will // see 'false' in the UI. // Otherwise, you will see the string formatted date debug: {dateFromUser, maxDate2} } } }); break; default: break; } } };
Agente do Small Talk
Este modelo ajuda a personalizar agentes com perguntas simples.
Exemplos de declarações
- Tudo bem?
- Quem é você?
- Hoje é meu aniversário.
- Desculpe.
- Como assim?
Agente de telecomunicações
Esse modelo ajuda os usuários finais a resolver dúvidas sobre faturamento e planejamento, solucionar problemas e adicionar planos de viagem e cruzeiros.
Exemplos de declarações
- Como posso economizar dinheiro na minha conta?
- Meus textos não estão funcionando.
- Quanto vou pagar se eu fizer upgrade para o Plano A?
- Preciso de cobertura de dados para uma viagem que vou para a Jamaica.
Webhook
O webhook do Cloud Functions executa as seguintes ações:
- Compara os custos do plano com base no local e na duração da viagem
- Identifica anomalias de faturamento com base no número de telefone de um usuário final
package.json
{
"name": "sample-http",
"version": "0.0.1",
"dependencies": {
"moment": "2.24.0"
}
}
helpers.js
// Get the current month, first day of current month and last month values // based on today's date module.exports = { get_date_details: function (bill_state) { const monthNames = ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ]; let today = new Date() let first_month_name = monthNames[today.getMonth()] let firstDay = new Date(today.getFullYear(), today.getMonth(), 1); let first_day_str = first_month_name + ' 0' + firstDay.getDate() + ', ' + firstDay.getFullYear() let last_month_name = monthNames[today.getMonth() - 1] let last_month_first_day_str = last_month_name + ' 0' + firstDay.getDate() + ', ' + firstDay.getFullYear() let second_last_month_name = monthNames[today.getMonth() - 2] if (bill_state.toString() == 'current') { return [first_month_name, first_day_str, last_month_name] } else { return [last_month_name, last_month_first_day_str, second_last_month_name] } } }
index.js
/** * Responds to any HTTP request. * * @param {!express:Request} req HTTP request context. * @param {!express:Response} res HTTP response context. */ const helpers = require('./helpers.js') exports.cxPrebuiltAgentsTelecom = (req, res) => { console.log('Cloud Function:', 'Invoked cloud function from Conversational Agents (Dialogflow CX)'); let tag = req.body.fulfillmentInfo.tag; if (!!tag) { switch (tag) { //BEGIN detectCustomerAnomaly case 'detectCustomerAnomaly': console.log(tag + ' was triggered.'); let phone_number = req.body.sessionInfo.parameters.phone_number; let bill_month = req.body.sessionInfo.parameters.bill_state; let parameters = req.body.sessionInfo.parameters; let bill_amount; let product_line; let anomaly_detect = "false" let purchase = "The Godfather" let purchase_amount = 9.99 let total_bill_amount = 64.33 let bill_without_purchase = 54.34 let updated_parameters = {} let [month_name, first_of_month, last_month_name] = helpers.get_date_details(bill_month) console.log(month_name, first_of_month, last_month_name) // Getting the month name based on the bill state - current or previous // For example, if the current month is December, we get the values as // December, December 1st, November // Only 999999 will have anomaly detection if (phone_number.toString() == '999999') { anomaly_detect = "true" product_line = "phone" purchase = "device protection" updated_parameters["product_line"] = product_line updated_parameters["bill_month"] = month_name updated_parameters["last_month"] = last_month_name } // If bill hike amount is given - we just add it to the total bill if ('bill_amount' in parameters) { bill_amount = parameters['bill_amount'] purchase_amount = bill_amount['amount'] total_bill_amount = 54.34 + purchase_amount } // Adding the updated session parameters to the new parameters json updated_parameters["anomaly_detect"] = anomaly_detect updated_parameters["purchase"] = purchase updated_parameters["purchase_amount"] = purchase_amount updated_parameters["bill_without_purchase"] = bill_without_purchase updated_parameters["total_bill"] = total_bill_amount updated_parameters["first_month"] = first_of_month res.status(200).send({ sessionInfo: { parameters: updated_parameters } }); break; // BEGIN validatePhoneLine case 'validatePhoneLine': console.log(tag + ' was triggered.'); let phone = req.body.sessionInfo.parameters.phone_number; let phone_line_verified; let line_index; let domestic_coverage; let covered_lines = ['5555555555', '5105105100', '1231231234', '9999999999']; // Loop over the covered lines array covered_lines.forEach((line, index) => { // For each phone line in the array, check if the last 4 digits are // included in the string. when true, update the line_index variable if (line.includes(phone)) { line_index = index; console.log('This is the index ' + line_index); } }); // Only 9999 will fail; if (line_index === 3) { phone_line_verified = 'false'; } else { phone_line_verified = 'true'; } // Only 1234 will have domestic coverage. if (line_index === 2) { domestic_coverage = 'true'; } else { domestic_coverage = 'false'; } res.status(200).send({ sessionInfo: { parameters: { phone_line_verified: phone_line_verified, domestic_coverage: domestic_coverage } } }); break; // BEGIN cruisePlanCoverage case 'cruisePlanCoverage': console.log(tag + ' was triggered.'); let port = req.body.sessionInfo.parameters.destination; let port_is_covered; // Sample list of covered cruise ports. let covered_ports = [ 'mexico', 'canada', 'anguilla', ]; if (covered_ports.includes(port.toLowerCase())) { port_is_covered = 'true'; } else { port_is_covered = 'false'; } res.status(200).send( { sessionInfo: { parameters: { port_is_covered: port_is_covered } } }); break; // BEGIN internationalCoverage case 'internationalCoverage': console.log(tag + ' was triggered.'); let destination = req.body.sessionInfo.parameters.destination; let coverage; // Sample list of covered international monthly destinations. let covered_by_monthly = [ 'anguilla', 'australia', 'brazil', 'canada', 'chile', 'england', 'france', 'india', 'japan', 'mexico', 'russia', 'singapore', ]; // Sample list of covered international daily destinations. let covered_by_daily = [ 'anguilla', 'australia', 'brazil', 'canada', 'chile', 'england', 'france', 'india', 'japan', 'mexico', 'singapore' ]; if (covered_by_monthly.includes(destination.toLowerCase()) && covered_by_daily.includes(destination.toLowerCase())) { coverage = 'both'; } else if ( covered_by_monthly.includes(destination.toLowerCase()) && !covered_by_daily.includes(destination.toLowerCase())) { coverage = 'monthly_only'; } else if ( !covered_by_monthly.includes(destination.toLowerCase()) && !covered_by_daily.includes(destination.toLowerCase())) { coverage = 'neither'; } else { // This should never happen, because covered_by_daily is a subset of // covered_by_monthly coverage = 'daily_only'; } res.status(200).send({ sessionInfo: { parameters: { coverage: coverage } } }); break; // BEGIN cheapestPlan case 'cheapestPlan': console.log(tag + ' was triggered.'); let trip_duration = req.body.sessionInfo.parameters.trip_duration; let monthly_cost; let daily_cost; let suggested_plan; // Can only suggest cheapest if both are valid for location. // When trip is longer than 30 days, calculate per-month cost (example $ // amounts). Suggest monthly plan. if (trip_duration > 30) { monthly_cost = (Math.floor(trip_duration / 30)) * 70; daily_cost = trip_duration * 10; suggested_plan = 'monthly'; } // When trip is <= 30 days, but greater than 6 days, calculate monthly // plan cost and daily plan cost. Suggest monthly b/c it is the cheaper // one. else if (trip_duration <= 30 && trip_duration > 6) { monthly_cost = 70; daily_cost = trip_duration * 10; suggested_plan = 'monthly'; } // When trip is <= 6 days, calculate daily plan cost. Suggest daily // plan. else if (trip_duration <= 6 && trip_duration > 0) { monthly_cost = (Math.floor(trip_duration / 30)) * 70; daily_cost = trip_duration * 10; suggested_plan = 'daily'; } else { // This should never happen b/c trip_duration would have to be // negative suggested_plan = 'null'; } res.status(200).send({ sessionInfo: { parameters: { monthly_cost: monthly_cost, daily_cost: daily_cost, suggested_plan: suggested_plan } } }); break; default: console.log('default case called'); res.status(200).end(); break; } } };
Viagem: agente para reivindicar bagagens
Esse modelo ajuda os usuários finais a criar ou verificar o status de uma reivindicação relacionada a bagagens perdidas, atrasadas ou danificadas.
Exemplos de declarações
- Poderia me ajudar a abrir uma reivindicação de uma bagagem que você perdeu?
- Quero saber o status da minha reivindicação de bagagem danificada.
- Quando minha bagagem vai chegar?
Webhook
Este webhook do Cloud Functions executa as seguintes ações:
- Verifica os detalhes do usuário e do voo.
- Gera um ID da reivindicação e retorna informações dela.
package.json
{
"name": "sample-http",
"version": "0.0.1",
"dependencies": {
"moment": "2.27.0"
}
}
index.js
const moment = require('moment') /** * Responds to any HTTP request. * * @param {!express:Request} req HTTP request context. * @param {!express:Response} res HTTP response context. */ exports.cxPrebuiltAgentsClaimStatus = (req, res) => { let tag = req.body.fulfillmentInfo.tag; let passenger_last_name; if (!!tag) { switch (tag) { // Check Claim Status tag // Validates that the claim ID is 'REF123456' // And that the last name is 'Garcia' // Sends back a static status message case 'claimStatus': console.log(tag + ' was triggered.') let claim_id = req.body.sessionInfo.parameters.claim_id; passenger_last_name = req.body.sessionInfo.parameters.passenger_last_name; let claim_status; if (claim_id == 'REF123456' && passenger_last_name == "Garcia") { claim_status = 'valid'; } else { claim_status = 'invalid'; } let claim_status_message = 'Your lost bag claim is being processed and you should receive payment to your account ending in 6873 within 5-7 business days. ' res.status(200).send({ sessionInfo: { parameters: { claim_status: claim_status, claim_status_message: claim_status_message } } }); break; // Case to submit a new claim and generate a confirmation ID // Validates that the flight number = AJ143, last name = Garcia // and reference id = 1234567890123 // Ideally you would include better logic, this is just an example of a working webhook case 'submitClaim': console.log(tag + ' was triggered.') // Currently not using these two parameters but just an example let claim_type = req.body.sessionInfo.parameters.claim_type; let passenger_flight_date = req.body.sessionInfo.parameters.passenger_flight_date; // Calculate qualifying rebate amount for delayed bags let rebate_amount = 0 if (claim_type == 'delayed') { let date_difference = Math.abs(moment(passenger_flight_date).diff(moment(), 'days')); // Cap the qualifying days at 5 let rebate_qual_days = Math.min(date_difference, 5) // An example of giving $50 per day of delay rebate_amount = rebate_qual_days * 50 } // These parameters are being checked let passenger_flight_number= req.body.sessionInfo.parameters.passenger_flight_number; passenger_last_name= req.body.sessionInfo.parameters.passenger_last_name; let passenger_reference_id= req.body.sessionInfo.parameters.passenger_reference_id; let claim_confirmation_id; if (passenger_flight_number == 'AJ143' && passenger_last_name == 'Garcia' && passenger_reference_id == '1234567890123') { claim_filed = true; // Generate random 6 digit number to return const rand_id = Math.floor(100000 + Math.random() * 900000) claim_confirmation_id = 'REF' + rand_id.toString() } else { claim_filed = false; } res.status(200).send({ sessionInfo: { parameters: { claim_filed: claim_filed, claim_confirmation_id: claim_confirmation_id, rebate_amount: rebate_amount } } }); break; // This is the case to verify form parameters that get updated throughout the conversation case 'verifyParameters': // Capture newly updated form parameters console.log(tag + ' was triggered.') let params = req.body.pageInfo.formInfo.parameterInfo let paramToValidate = {name: '', value: ''} // Only validate the form parameter if it was just collected for (let param of params) { if (param.justCollected == true) { console.log('Received parameter: ', param) paramToValidate = param; } } // Validate Passenger Reference ID // Must == '1234567890123' in order to continue if (paramToValidate.displayName == 'passenger_reference_id') { if (paramToValidate.value != '1234567890123') { paramToValidate.state = 'INVALID' } else { paramToValidate.state = 'VALID' } } // Validate Flight Date // Must be on or before current date if (paramToValidate.displayName == 'passenger_flight_date') { let flight_date = paramToValidate.value let now = moment() if ((moment(flight_date) <= now)) { paramToValidate.state = 'VALID' } else { paramToValidate.state = 'INVALID' } } res.status(200).send({ pageInfo: { formInfo: { parameterInfo: [paramToValidate] } } }); break; default: break; } } };
Viagens: agente de aluguel de carros
Este modelo ajuda os usuários finais a iniciar uma nova reserva de aluguel de carro.
Exemplos de declarações
- Preciso reservar uma van.
- Olá, vou viajar para Los Angeles para ir ao fim de semana e preciso alugar um carro enquanto estou no local.
- Preciso de ajuda para reservar um SUV.
Viagens: agente de informações de voo
Esse modelo ajuda os usuários finais a reservar e alterar passagens, encontrar informações sobre voos e solicitar o reembolso.
Exemplos de declarações
- Meu voo XX05997 precisa ser alterado. Você pode me ajudar?
- Você pode me ajudar a descobrir o novo horário de partida do meu voo?
- E o crédito na minha conta do voo cancelado?
- Você pode reservar meu voo para São Francisco no próximo mês?
- Faça uma reserva de SFO 10h para MIA no dia 10 de agosto de 2020.