Os agentes de IA só são tão poderosos quanto os dados a que podem aceder. Embora os modelos de linguagem de grande dimensãoLLMs) gerem respostas a partir de dados de treino, não podem obter preços de acções em tempo real, processar pagamentos ou aceder a detalhes de CRM - a menos que estejam integrados em API.
As APIs permitem que os agentes de IA acedam a dados em tempo real, executem lógica e desencadeiem acções. Para tirar o máximo partido delas, os agentes precisam de código personalizado.
O cartão 'Executar código' no Botpress Studio permite escrever e executar JavaScript dentro do fluxo de trabalho de um bot - lidando perfeitamente com chamadas de API, processamento de dados e personalização do comportamento do bot.
O que é o cartão Execute Code?
O cartão Executar código no Botpress permite que os desenvolvedores executem JavaScript personalizado dentro do fluxo do bot. Ele habilita as seguintes funções:
- Implementação de lógica personalizada: É possível executar cálculos complexos ou transformar dados de formas não abrangidas pelas acções standard.
- Interações dinâmicas: Ajustar as respostas com base nos dados do utilizador ou em cálculos em tempo real.
- Integrações de dados: Ligue-se facilmente a serviços de terceiros para obter ou enviar dados.
- Gerenciamento de estado: Aceder e modificar o estado do bot para manter o contexto e personalizar as interações.
- Tratamento de erros: Implementar gestão de erros personalizada para garantir operações robustas.
Ocartão Execute Code apresenta sugestões de código geradas por IA. Insira um prompt, como buscar dados da API, e o sistema gera JavaScript instantaneamente. Em seguida, pode rever, editar e aperfeiçoar o código conforme necessário, acelerando o desenvolvimento.
Porque é que os agentes de IA precisam de APIs externas?
Os agentes de IA são tão úteis quanto os dados e serviços a que acedem. Embora possam processar entradas e gerar respostas, não têm conhecimento em tempo real, capacidades transaccionais e integrações profundas sem APIs externas.
Quer esteja a integrar dados em tempo real, a automatizar fluxos de trabalho ou a melhorar a segurança, as APIs tornam o seu bot mais inteligente, reativo e integrado.
5 maneiras de utilizar o cartão Execute Code
O cartão Executar código no Botpress Studio simplifica as operações do agente de IA. Adicioná-lo ao seu fluxo de trabalho é simples - siga este rápido tutorial:
Umavez adicionado, eis as principais formas de o aproveitar no seu Agentic Workflow.
1. Chamadas dinâmicas à API
Em vez de utilizar chamadas de API estáticas, o cartão Execute permite-lhe modificar dinamicamente os pedidos com base na intenção do utilizador, no contexto do bot ou em conversas anteriores.
Exemplo: Obtenção de dados personalizados com base nas preferências do utilizador.
Sugestão: Um chatbot de viagens precisa de obter preços de hotéis com base no destino, nas datas de viagem e no orçamento do utilizador.
.webp)
Nota: O Cartão Executar Código pode gerar código a partir de linguagem natural. No entanto, verifique sempre as variáveis usadas no seu código gerado antes de implantar o fluxo de trabalho na produção.
2. Pós-processamento das respostas LLM
Embora Botpress forneça acções de IA incorporadas, por vezes é necessário afinar as respostas antes de as mostrar aos utilizadores, quer se trate de formatar os resultados, filtrar determinadas palavras ou estruturar os dados de forma mais clara.
Exemplo: Reescrever respostas LLM não estruturadas numa tabela/formato definido.
Prompt: A IA vai buscar recomendações de restaurantes a uma API, e quero que as formate numa tabela limpa antes de as apresentar.
.webp)
3. Execução condicional e com limitação de taxa
Algumas APIs, incluindo carteiras digitais, têm limites de utilização. Com o cartão Executar código, pode controlar as interações do utilizador impondo limites de taxa, definindo fallbacks e adicionando lógica condicional com base na disponibilidade da API.
Exemplo: Verificando o uso da API antes de chamá-la
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. Tratamento das permissões
Se o seu bot precisar de verificar os utilizadores antes de conceder acesso a determinadas funcionalidades, o cartão permite fluxos de autenticação personalizados que vão além das opções predefinidas do Botpress.
Exemplo: Verificando o status da assinatura do usuário antes de fornecer respostas de IA
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. Encadeamento de APIs em várias etapas
Por vezes, um bot precisa de combinar dados de várias APIs antes de enviar uma resposta final. O cartão permite fluxos de trabalho complexos em várias etapas ao buscar, transformar e transmitir dados dinamicamente.
Exemplo: Obtenção de tempo + reserva de restaurante para recomendar a melhor hora para sair
Prompt: Obter dados meteorológicos e de tráfego para workflow.city usando workflow.userApiKey. Com base nas condições, devolver o melhor tempo de viagem. Lidar com falhas.
.webp)
Integrações de API sem descontinuidades para agentes de IA
Os agentes de IA funcionam melhor quando podem aceder a dados em tempo real, automatizar fluxos de trabalho e ligar-se a serviços externos.
Botpress Hub facilita isso com integrações de API pré-criadas, ferramentas de automação e conectores prontos para uso, para que você possa se concentrar na criação, não na configuração.
Comece aintegrar APIs poderosas nos fluxos de trabalho do seu bot hoje mesmo - é grátis.
.svg)
.webp)
