4 min de leitura
Custom Tools: deixe Max e seus agentes ligarem para os APIs que você já usa
Crie Custom Tools Frontline a partir de um API. Argumentos, cabeçalhos, testes e como Max escreve uma ferramenta a partir da documentação.
Uma Custom Tool é uma chamada API de propriedade de sua conta. Você nomeia, descreve quando usá-lo, aponta para um endpoint e decide quais argumentos o modelo preenche. Em seguida, você o atribui a Max, a um agente, a um playbook ou a uma tarefa.
A Frontline já se comunica com o seu CRM e com integrações conectadas. Uma Custom Tool é a porta para todo o resto. Sistema de portfólio de Harrington. O guardião. O portal de cobrança. Um fornecedor KYC. Se tiver um HTTP API, pode ser uma ferramenta.
A descrição é a parte que o modelo lê quando decide chamar a ferramenta. “Obter o PDF do extrato mais recente de uma família por número de conta” será usado em perguntas sobre extratos. O “endpoint interno 4b” permanecerá sem uso. Escreva a descrição da mesma forma que você informaria um novo contratado.
O que acontece em uma Custom Tool?
Comece com o pedido.
Método e URL. GET, POST, PUT, PATCH ou DELETE. A URL pode incluir espaços reservados, como um caminho que leva {accountNumber}.
Argumentos são as entradas que o modelo fornece em tempo de execução. Cada um tem um nome, uma descrição, um tipo (texto, número ou verdadeiro/falso), se é obrigatório e um padrão opcional. O nome que você declara é o nome que você coloca no URL, nos cabeçalhos, na string de consulta ou no corpo como {accountNumber}.
Os cabeçalhos carregam autenticação e tipo de conteúdo. Um token de portador, uma chave API, Content-Type: application/json.
Parâmetros de consulta são extras em um GET. Inclui objetos relacionados. Filtrar por data.
Body é o JSON para POST, PUT e PATCH. Os mesmos espaços reservados. {householdName} no corpo se torna o valor escolhido pelo modelo.
Você pode testar uma ferramenta com valores reais antes que alguém a utilize. O teste retorna o status, quanto tempo demorou e a resposta. Esse é o momento em que você encontra um cabeçalho errado ou um caminho que ainda contém um espaço reservado.
As ferramentas podem estar ativas ou pausadas. Faça uma pausa quando o fornecedor estiver em manutenção. Ligue-o novamente quando o endpoint estiver íntegro.
Onde as Custom Tools são usadas?
Em qualquer lugar onde um modelo possa atuar.
Em um agente, a ferramenta está no kit de ferramentas do agente. O qualificador WhatsApp pode verificar se James já possui uma família no sistema de portfólio antes de criar um Deal.
No Max, a ferramenta está disponível no chat e no trabalho que o Max faz para você. “Retire o extrato do mês passado para a família Harrington” torna-se uma chamada de ferramenta e depois uma resposta.
Em um Playbook do agente, a ferramenta tem como escopo esse procedimento. O Playbook “Enviar extrato” pode chamar o portal. O Playbook do “Mandato de qualificação” nunca vê isso.
Em uma tarefa Max, a mesma ideia. Uma revisão do pipeline na segunda-feira pode chamar o portfólio de API para AUM antes de redigir o briefing.
Como o Max escreve uma Custom Tool a partir dos documentos do API?
Esta é uma das maneiras mais rápidas de colocar uma ferramenta em produção.
Cole a documentação do fornecedor em Max ou aponte-a para o URL dos documentos públicos. Diga o que quiser em linguagem simples. "Crie uma ferramenta que busque o extrato mais recente de uma família. Os documentos estão aqui. Auth é um token ao portador. Preciso do número da conta como entrada."
Max lê o caminho, o método, os argumentos e os cabeçalhos e, em seguida, cria a ferramenta. Você testa com um número de conta Harrington conhecido. Se a resposta parecer correta, atribua-a a Max, ao agente ou ao Playbook que deve possuí-la.
Um agente de codificação no CLI pode fazer o mesmo loop. Crie a ferramenta, teste com valores, leia a resposta, corrija o corpo ou cabeçalho, teste novamente. O CLI é útil quando a definição deve estar em um repositório próximo ao restante da configuração da conta.
Qual é a aparência de uma boa primeira ferramenta?
Mantenha o primeiro em um único trabalho.
A primeira Custom Tool de Harrington é “Obter instantâneo da família”. GET, número da conta no caminho, token ao portador no cabeçalho, descrição que diz que retorna AUM, custodiante e data do último extrato. Teste na conta de James. Atribua-o a Max e ao agente qualificado.
A segunda ferramenta pode criar um ticket de serviço no sistema operacional quando a integração for iniciada. POST, nome familiar e tamanho do mandato no corpo. Coloque isso no Playbook de integração, não em todos os agentes.
Nomeie a ferramenta para o resultado. Descreva os argumentos da maneira como uma pessoa os pediria. Em seguida, deixe o modelo preenchê-los.