Uma função personalizada permite que a IA consulte ou envie dados a um sistema externo por uma API. Ela faz sentido quando a resposta depende de uma informação que muda, como a situação de um pedido, e que não deve ficar apenas em um texto fixo.
Comece pela necessidade do cliente e envolva quem mantém o outro sistema. É preciso confirmar que existe uma operação adequada, quais dados ela recebe e qual resultado devolve. O nome da função e a descrição ajudam a orientar quando essa operação deve ser usada.
Como começar
- Defina a finalidade da função e confirme que o sistema externo oferece a operação necessária.
- Informe nome, descrição, método e endereço da API.
- Configure os campos esperados e, se necessário, autenticação e parâmetros adicionais.
- Valide a configuração e teste a resposta com dados de exemplo autorizados.
Quais configurações exigem apoio técnico
A tela permite definir campos em JSON Schema, cabeçalhos de autenticação, parâmetros de consulta, corpo da requisição e tempo limite. Esses ajustes normalmente precisam do responsável técnico pela integração. A descrição deve explicar à IA quando a função faz sentido.
Exemplo prático: uma resposta que depende de outro sistema
Exemplo ilustrativo. Uma loja quer consultar a situação de um pedido durante a conversa. O responsável técnico confirma que a API da loja oferece essa consulta e define quais dados identificam o pedido.
A equipe descreve quando a IA deve chamar a função e testa uma consulta autorizada. Também verifica o que acontece quando o pedido não é encontrado, para não transformar uma resposta vazia em uma informação inventada.
O cliente pergunta sobre o pedido fictício EX-01. A função faz uma consulta autorizada à API da loja, e o retorno é conferido antes da resposta; se não houver resultado, a situação do pedido não deve ser inventada.
Exemplo ilustrativo em 3D com dados fictícios. Uma resposta que depende de outro sistema. Os elementos da imagem estão explicados no texto acima. Abrir imagem ampliada.
O que combinar antes da configuração técnica
Defina quais situações permitem a consulta e que dados precisam ser confirmados com o cliente. Diferencie uma consulta de uma operação que altera informações no outro sistema.
A base de conhecimento continua necessária para orientar o atendimento e explicar como tratar o resultado.
Antes de usar: A integração depende de uma API acessível e autorizada. Não basta cadastrar o nome de um sistema para integrá-lo. Operações que alteram dados precisam de regras e testes adequados; não coloque credenciais no texto público da base.
Perguntas frequentes
Uma função substitui a base de conhecimento?
Não. A base orienta sobre o negócio; a função acessa uma operação externa quando isso é necessário.
Preciso de apoio técnico?
A configuração inclui API, autenticação e formato dos dados. Envolva quem mantém o sistema externo para validar esses detalhes.
Basta escrever o nome do sistema para conectar?
Não. É necessária uma API compatível e autorizada, com endereço, autenticação e formato de dados configurados e testados.
Continue explorando
Leve essa organização para o seu atendimento
Conheça o Chat Inteligente e explore os recursos para a rotina da sua equipe.
Conhecer o Chat Inteligente Explorar recursos avançados
