Funções personalizadas: conecte a IA aos dados do seu negócio

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

1. Defina a finalidade da função e confirme que o sistema externo oferece a operação necessária.
2. Informe nome, descrição, método e endereço da API.
3. Configure os campos esperados e, se necessário, autenticação e parâmetros adicionais.
4. 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.

Esquema ilustrativo do exemplo. As etapas estão explicadas 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.