Em resumo
- Respostas reais dos seus sistemas.O agente lê dados ao vivo da sua API, como o status de um pedido, em vez de adivinhar a partir de uma página de ajuda.
- Assinada e segura para repetir.Cada chamada é assinada para que o seu servidor possa provar que veio da OneType, e leva uma chave de idempotência estável.
- Os visitantes aprovam as alterações.Ferramentas que alteram algo perguntam antes ao visitante no chat, e as destrutivas sempre perguntam.
- Sem números de pedido inventados.Um número de pedido ou outro ID precisa vir do visitante, da página ou de um resultado anterior, nunca da imaginação do modelo.
A maioria dos chatbots para na resposta. Um visitante pergunta onde está o pedido e o chatbot o manda para uma página de rastreamento. Com as ações de API, o seu agente chama o seu próprio sistema, lê o status real e conta a ele na mesma conversa. É como falar com alguém da sua equipe que está com a tela certa aberta.
Como funciona
Uma API é o endereço em que o seu próprio software responde. Com as ações de API (em breve), você adiciona uma ferramenta: dê um nome a ela, descreva em palavras simples quando o agente deve usá-la e informe o método e o endereço https do seu endpoint. Você descreve os dados de entrada de que ela precisa, como um número de pedido, em um pequeno JSON Schema. Quando um visitante pergunta algo que se encaixa, o agente preenche esses dados, a OneType chama o seu endpoint e o agente responde com o que a sua API devolveu.
- Escolha o método: GET, POST, PUT, PATCH ou DELETE.
- Coloque os dados de entrada no caminho com {parameter}; o restante vai na query ou no corpo JSON.
- Adicione cabeçalhos e marque as credenciais como secretas, para que fiquem protegidas e nunca sejam mostradas de novo.
- Diga o que a ferramenta faz com os seus dados: lê, altera algo ou é destrutiva.
O agente encadeia etapas por conta própria
Uma resposta pode usar várias ferramentas. O agente pode consultar um pedido, depois checar o prazo de devolução e depois se oferecer para transferir a conversa a uma pessoa, tudo em uma só resposta. Ele pode fazer até 20 chamadas de ferramenta em uma única resposta, e um agente pode ter até 100 ferramentas.
Feito para que a sua API possa confiar
Cada chamada é assinada com um segredo de assinatura por agente, usando o esquema aberto Standard Webhooks, para que o seu servidor possa verificar que ela realmente veio da OneType. Cada chamada também leva uma chave de idempotência que permanece a mesma em uma nova tentativa, para que a sua API possa ignorar duplicatas. A OneType só chama endereços públicos da internet e nunca segue redirecionamentos.
Para dados pessoais, ative “Only for signed-in visitors”. A chamada passa a incluir o contato verificado, tirado do seu próprio token de identidade assinado, de modo que o modelo nunca possa escolher de quem é a conta consultada. Visitantes anônimos são recusados.
Alterações exigem o clique do visitante
Uma ferramenta que apenas lê roda na hora. Uma ferramenta que altera algo mostra ao visitante uma pergunta que você escreve, como Cancelar o pedido #1234?, e só roda depois que ele clica para aprovar. As ferramentas destrutivas sempre perguntam. IDs como números de pedido ou SKUs precisam vir do que o visitante digitou, do que a página mostra ou de um resultado anterior de ferramenta. Se o modelo inventar um, a chamada não roda e o agente é orientado a buscar a informação ou perguntar.
Veja como funciona a aprovação do visitante
Limites a conhecer
Seu endpoint precisa responder com JSON em até 10 segundos, e o agente lê até 32 KB dele. Cada ferramenta tem o seu próprio limite de chamadas por minuto, de 1 a 60, sendo 10 o padrão. Se uma chamada falhar, o agente é avisado e segue em frente, por exemplo oferecendo uma pessoa.