Entendendo as Ferramentas

As ferramentas permitem que a IA aja As ferramentas são a ponte entre o agente de IA e sua organização Salesforce. Elas permitem que o agente busque, consulte e modifique dados ativamente durante as conversas.

O que são ferramentas?

As ferramentas na REDA AI são integrações pré-construídas que permitem que o agente de IA interaja com o Salesforce. Sem ferramentas, a IA só pode fazer sugestões com base em prompts e contexto estático. Com ferramentas, a IA pode consultar registros ativamente, criar novos dados, atualizar campos e realizar ações.

Nos bastidores, as ferramentas são definidas como registros de Metadados Personalizados. A REDA AI vem com um conjunto abrangente de ferramentas integradas que cobrem as operações comuns do Salesforce, que você atribui aos seus agentes conforme necessário. Quando uma ferramenta integrada não cobre o que você precisa, você também pode criar sua própria ferramenta personalizada — veja Configuração de Ferramentas.

As duas categorias de ferramentas

Categoria	Valor do campo	Capacidade	Exemplos
Tool (somente leitura)	Tool	Consulta dados do Salesforce sem alterar nada	soql_query, get_record, count_records, describe_object, get_picklist_values, get_record_types
Action (leitura e escrita)	Action	Cria, atualiza, exclui registros ou aciona ações	create_record, update_record, delete_record, send_email, create_task, create_event, schedule_action, link_file_to_record, send_custom_notification

Ferramentas comuns disponíveis por padrão

Nome da ferramenta	Categoria	Finalidade
soql_query	Tool	Consulta registros usando SOQL com filtros, ordenação e seleção de campos
get_record	Tool	Recupera um único registro por ID e retorna todos os campos acessíveis
count_records	Tool	Conta registros que correspondem a critérios (por exemplo, “quantos casos estão abertos?”)
describe_object	Tool	Obtém metadados sobre um objeto do Salesforce (nomes de campos, tipos, relacionamentos)
get_picklist_values	Tool	Obtém os valores da lista de seleção de um campo específico
get_record_types	Tool	Obtém os tipos de registro disponíveis para um objeto
create_record	Action	Cria um novo registro do Salesforce com os valores de campo especificados
update_record	Action	Atualiza campos específicos de um registro existente
delete_record	Action	Exclui um registro (movido para a lixeira)
send_email	Action	Envia um e-mail do usuário para os destinatários especificados
create_task	Action	Cria um novo registro de tarefa
create_event	Action	Cria um evento de agenda
schedule_action	Action	Agenda uma ação futura (é executada sem confirmação)
link_file_to_record	Action	Anexa um arquivo enviado a um registro do Salesforce
send_custom_notification	Action	Envia uma notificação personalizada do Salesforce a usuários especificados

Recursos adicionais

Além das ferramentas listadas acima, os agentes da REDA AI também podem usar a Pesquisa na Web (buscar na internet informações em tempo real) e o Upload de Arquivos (processar documentos, imagens e dados CSV enviados). Esses recursos são habilitados por agente na Definição de Agente — veja as páginas dedicadas para mais detalhes.

Como a IA decide chamar ferramentas

Quando um usuário envia uma mensagem, a IA processa da seguinte forma:

A IA recebe a mensagem
O usuário faz uma pergunta ou solicita uma ação.
A IA analisa as ferramentas disponíveis
A IA revisa a lista de ferramentas atribuídas a esse agente.
A IA decide se uma ferramenta é necessária
Com base na pergunta do usuário, a IA decide se chamar uma ferramenta ajudaria. Exemplo: "Para responder a essa pergunta, preciso consultar as Oportunidades dessa conta" → chama soql_query.
A IA constrói a chamada da ferramenta
A IA formula os parâmetros necessários. Exemplo: soql_query(object="Oportunidade", filters={"AccountId": "001xx000003DHP"})
A REDA AI executa a ferramenta
A REDA AI intercepta a chamada da ferramenta, valida as permissões e a executa no Salesforce.
Os resultados são retornados à IA
O resultado da ferramenta é enviado de volta para a IA. Exemplo: [{"Id": "006xx000001SMeAAM", "StageName": "Negotiation/Review", "Amount": 50000}, ...]
A IA formula a resposta
A IA usa o resultado da ferramenta para responder à pergunta original do usuário com dados específicos.

Ferramentas do tipo Action exigem confirmação

No canal Internal, antes de executar uma ferramenta de Action cujo Requires Confirmation esteja ligado (create_record, send_email, update_record e outras quatro), o agente exibe um cartão de confirmação. O cartão de confirmação exibe:

Qual ação será executada (por exemplo, "Criar Tarefa")
Os principais valores de campo que serão definidos (por exemplo, Assunto, Data de Vencimento, Prioridade)
Um botão "Confirmar" para prosseguir ou "Cancelar" para abortar

Isso evita alterações acidentais nos dados. O usuário precisa aprovar conscientemente cada ação antes que ela seja executada.

Dois limites nisso. Três ferramentas de Action têm o Requires Confirmation desligado e nunca exibem cartão: schedule_action, link_file_to_record e continue_workflow. E os cartões existem apenas no canal Internal: no widget externo e na Comunidade o agente executa a ação e depois narra o resultado, e no canal de API quem decide é um Fluxo, via Auto Execute Actions. Veja Confirmações de ação.

A REDA AI respeita o modelo de segurança do Salesforce. Quando a IA chama uma ferramenta:

Segurança em nível de campo (FLS) — A IA só pode acessar campos aos quais o usuário em execução tem acesso de leitura ou escrita. Campos que o usuário não pode acessar são excluídos.
Permissões em nível de objeto — A IA só pode consultar ou criar registros em objetos aos quais o usuário tem acesso.
Compartilhamento de registros — A IA só pode acessar registros compartilhados com o usuário por meio de regras de compartilhamento, padrões da organização ou hierarquia de papéis.
Uma exceção deliberada — um agente cujo Contexto de execução seja Sistema e cujo Canal seja API lê campos que o usuário em execução não pode ver. Mesmo assim, o compartilhamento de registros nunca é ampliado: ele vê mais campos em registros que já alcançava. Em todo o resto, a REDA AI opera estritamente como o usuário conectado. Veja Segurança dos dados.

Isso significa que um agente de IA é tão seguro quanto o usuário que o executa. Um agente de suporte acessado por um usuário do portal do cliente só pode ver e modificar registros compartilhados com esse usuário do portal.

As ferramentas integradas são gerenciadas pelo pacote

As ferramentas integradas listadas acima são definidas como registros de Metadados Personalizados gerenciados pelo pacote REDA AI. Isso significa que:

Você não pode editar ou remover a definição de uma ferramenta integrada — apenas atribuí-la a agentes ou deixá-la sem atribuição
O conjunto de ferramentas integradas é atualizado sempre que o pacote REDA AI é atualizado
As definições das ferramentas integradas são somente leitura na sua organização
Você configura quais ferramentas usar atribuindo-as aos agentes

Quando uma ferramenta integrada não cobre o que você precisa, crie uma ferramenta personalizada em vez disso — uma ferramenta de Modelo SOQL, Classe Apex ou Mapeamento de Arquivo — no Criador de Ferramentas. Veja Configuração de Ferramentas para o passo a passo completo.

Atribuição de ferramentas aos agentes

Você não usa todas as ferramentas em todos os agentes. Em vez disso:

Abra a Definição de Agente
Localize a lista relacionada "Tools"
Clique em "Add Tool"
Selecione apenas as ferramentas que esse agente precisa
Salve

Somente as ferramentas atribuídas ficam disponíveis para o agente. Ferramentas não atribuídas nunca são sugeridas pela IA.

Custo em tokens das ferramentas

Cada ferramenta disponível para o agente consome tokens em cada solicitação. Mesmo que a ferramenta não seja chamada, sua definição é incluída no contexto enviado à IA. Isso significa que:

Atribua apenas as ferramentas que o agente realmente precisa
Remova ferramentas não usadas para economizar tokens e reduzir custos
Uma configuração da plataforma controla quando as ferramentas são carregadas — sempre, ou apenas nas páginas de registro

Por exemplo, remover ferramentas desnecessárias de um agente reduz visivelmente o consumo de tokens por solicitação, diminuindo diretamente seus custos de créditos. Veja Carregamento e custo de ferramentas para ver como a lista de ferramentas estável e em cache no provedor mantém baixo o custo restante.

Perguntas frequentes

Sim. As ferramentas integradas que vêm com o pacote REDA AI são somente leitura, mas você pode criar sua própria ferramenta de Modelo SOQL, Classe Apex ou Mapeamento de Arquivo no Criador de Ferramentas sempre que as ferramentas integradas não cobrirem seu caso de uso. Veja Configuração de Ferramentas para o passo a passo completo.

A chamada da ferramenta falha com um erro de permissão. A IA recebe o erro e normalmente informa ao usuário "Você não tem permissão para acessar esses dados" ou algo semelhante. O erro não interrompe a conversa — a IA pode sugerir alternativas ou pedir mais informações.

Não. O schedule_action é único porque é executado silenciosamente, sem um cartão de confirmação. Isso ocorre porque ele agenda uma ação futura em vez de modificar dados imediatamente, e ações futuras agendadas podem ser canceladas pelo usuário depois, se necessário.

Pense no que o agente precisa fazer. Se for um agente de Vendas, provavelmente precisa de soql_query, create_task, create_event, send_email. Se for um agente de referência somente leitura, talvez você atribua apenas soql_query e describe_object. Use "Criar agente com IA" para obter recomendações.

Próximos passos

Saiba como configurar ferramentas para seus agentes, ou explore os cartões de confirmação de ações para entender como os usuários aprovam alterações nos dados.

Próximo: Configuração de Ferramentas →