Contexto
O MCP da Salvy permite que seu agente acesse informações da sua operação conforme elas são necessárias para atender a uma solicitação. Algumas informações já estão disponíveis para o agente, como as empresas às quais você tem acesso e as permissões que determinam quais operações podem ser realizadas. Outras informações precisam ser consultadas pelo agente utilizando as ferramentas do MCP. Por exemplo, para encontrar uma linha específica, o agente pode primeiro consultar as linhas disponíveis e, a partir dos resultados, identificar a informação necessária para realizar uma operação. Isso permite que o agente combine diferentes informações e ferramentas para atender a solicitações mais complexas. Por exemplo, ao pedir:Adicione até 5 GB às linhas que estão próximas de atingir o limite do plano.O agente pode precisar:
- consultar as linhas às quais você tem acesso;
- consultar o consumo dessas linhas;
- identificar quais estão próximas do limite;
- apresentar ou confirmar a operação, quando necessário;
- executar a ação nas linhas selecionadas.
Descoberta de informações
Nem sempre você precisa informar todos os detalhes para fazer uma solicitação. Quando o agente precisa de uma informação que não está no seu pedido, ele pode consultá-la no MCP antes de continuar. Por exemplo, se você pedir:Quais linhas estão próximas de atingir o limite do plano?O agente pode primeiro consultar as linhas às quais você tem acesso e, depois, consultar o consumo de cada uma para identificar quais estão próximas do limite. Você pode, portanto, fazer pedidos usando o que você conhece da sua operação, sem precisar conhecer IDs ou a estrutura interna da Salvy.
Operações em lote
Algumas operações do MCP da Salvy permitem realizar uma mesma ação em várias linhas de uma só vez. Você pode, por exemplo, pedir ao seu agente:Bloqueie as linhas dos colaboradores que saíram da empresa.Quando a operação permitir, o agente poderá identificar as linhas que estão vinculadas a colaboradores desligados e realizar a ação em conjunto, em vez de executar uma chamada individual para cada linha. Cada operação possui seus próprios limites e regras. Por isso, dependendo da quantidade de linhas e do tipo de ação, o agente pode precisar dividir a operação em diferentes etapas. O resultado também depende do tipo de operação. Algumas ações são executadas de forma conjunta, enquanto outras podem retornar um resultado individual para cada linha processada. O agente apresentará o resultado da operação e informará eventuais linhas que não puderam ser processadas.
Dica: quando você estiver trabalhando com várias linhas, descreva claramente o que deseja selecionar. Você pode usar critérios como colaborador, empresa ou status.
Confirmações
Algumas operações do MCP da Salvy, especialmente as que podem gerar uma cobrança, retornam ao agente as informações necessárias para que ele avalie a operação antes de executá-la. Quando necessário, o agente pode apresentar os detalhes da operação e pedir sua confirmação antes de continuar. A Salvy recomenda que os agentes sejam conservadores ao decidir quando solicitar essa confirmação, mas essa decisão fica a cargo do agente que você está utilizando. Por exemplo, ao pedir:Adicione 5 GB às linhas da Ana e do João.O agente pode primeiro consultar as linhas, identificar quais serão afetadas e consultar o valor da operação. A partir dessas informações, ele pode apresentar os detalhes para você e solicitar sua confirmação antes de adicionar os dados. Se o agente executar a operação sem solicitar uma confirmação, isso não significa que as permissões foram ignoradas. A confirmação é uma etapa de interação com o agente, enquanto a autorização da operação continua sendo verificada pelo MCP.
Resultados e estados
Depois de consultar informações ou realizar uma operação, o agente apresenta o resultado da solicitação e pode informar o estado da operação. Algumas ações são concluídas imediatamente. Outras podem depender de etapas adicionais ou levar algum tempo para serem processadas. Por exemplo, ao atribuir linhas a um centro de custo, o resultado pode indicar que as alterações foram agendadas para processamento. Nesse caso, o agente pode consultar novamente as linhas para verificar o resultado da operação. Da mesma forma, algumas consultas podem retornar estados específicos que fazem parte do funcionamento da operação. Por exemplo, uma linha pode não ter um status de portabilidade disponível naquele momento, sem que isso represente necessariamente um erro. Se uma operação ainda estiver em processamento, não a considere concluída até que o resultado indique que ela foi finalizada.Dica: se você não tiver certeza se uma operação foi concluída, peça ao agente para verificar o estado atual antes de tentar realizá-la novamente.