Em resumo
- Usa o código da sua própria página.O agente chama as ferramentas que você declara no seu painel e registra na página, com a sessão e o carrinho do próprio visitante.
- Pergunta antes de mudar qualquer coisa.Ações que mudam algo mostram um cartão de confirmação, e só o clique do visitante aprova.
- Buscar, depois agir.O agente pode encadear passos, como encontrar um produto e depois adicioná-lo ao carrinho, em uma só resposta.
- Só nas páginas certas.Limite cada ação a caminhos como /shop/*, para que ela seja oferecida só onde faz sentido.
Os visitantes muitas vezes sabem exatamente o que querem, mas não onde clicar. As ações do site deixam que simplesmente digam. Adicione dois pacotes do café do Quênia, mostre só opções veganas, agende uma demonstração na terça. O agente faz isso na sua página, e o visitante vê o resultado na hora.
Como funciona
Seu desenvolvedor registra uma ferramenta na página com uma chamada, onetype addTool, e você declara a mesma ferramenta no seu painel em “Developer › Tools”. Uma ferramenta tem um nome, uma descrição em palavras simples de quando usar, as entradas que recebe como um pequeno JSON Schema e um handler: seu próprio JavaScript que faz o trabalho, como chamar o seu carrinho. Quando um visitante pede algo que se encaixa, o agente preenche as entradas, a OneType as confere com o seu esquema e o seu handler roda no navegador do visitante.
- Diga o que a ação faz: leitura, escrita ou destrutiva.
- Escreva a pergunta de confirmação, com placeholders {param} preenchidos a partir das entradas.
- Limite a certas páginas, até 50 caminhos.
- Defina um timeout de 1 a 120 segundos, 15 por padrão.
- Atualize ou remova uma ferramenta a qualquer momento com updateTool e removeTool.
Mostre ao agente o que está na tela
O agente só pode usar um ID de produto que realmente viu. Passe os produtos da página atual com setContext, adicione uma ferramenta de busca para catálogos grandes ou deixe sua ferramenta aceitar nomes de produtos e procurar o ID no seu próprio código. Um ID inventado pelo modelo não vale: a chamada não roda, e o agente é instruído a buscar primeiro ou perguntar ao visitante.
O visitante continua no controle
Tudo o que muda a página ou o carrinho pergunta antes, a menos que você defina explicitamente o contrário. Ações destrutivas, como remover um item, sempre perguntam. A aprovação é um clique no chat, que nem o modelo nem um texto em uma página da web conseguem falsificar. Se o visitante recusar, o seu handler nunca roda.
Leia sobre a aprovação do visitante
Encadeamento de passos
O agente pode combinar ferramentas em uma resposta. Ele pode buscar no seu catálogo e depois adicionar o item certo ao carrinho, ou consultar um pedido no seu servidor com uma ação de API e depois abrir a página do pedido no navegador. Ele pode fazer até 20 chamadas de ferramenta em uma única resposta.
Os argumentos são conferidos com o seu esquema antes de o seu handler rodar, então uma chamada inválida nunca chega ao seu código e o agente é informado do que estava errado. Seu handler pode retornar qualquer resultado JSON, e o agente o usa na resposta. Informe valores com o código da moeda para que o agente nunca precise adivinhá-la.