Carregamento e custo de ferramentas
Como funciona o carregamento de ferramentas
Em cada chamada ao modelo, a plataforma monta a caixa de ferramentas do agente a partir das Definições de ferramenta ativas e a envia com a solicitação. Uma ferramenta entra na lista quando passa por todos estes filtros:
- Ativa — a Definição de ferramenta está marcada como ativa.
- Escopo de agente — as ferramentas integradas estão disponíveis para todos os agentes; uma ferramenta personalizada pode ser limitada a um agente específico pelo seu campo Agente.
- Canal — a seleção de Canais da ferramenta inclui o canal em que a conversa é executada.
- Contexto — se a ferramenta especifica Objetos de Contexto, o objeto do registro atual deve corresponder.
- Não excluída — a ferramenta não está na lista de exclusões deste agente (definida com o Edit Loadout na Pré-visualização de Execução do Agente).
- Dentro do Máx. de ferramentas — a configuração Máx. de ferramentas do agente (1–100, padrão 25) limita quantas ferramentas são oferecidas, por Ordem de Classificação.
A lista resultante é a mesma em todos os turnos da conversa — e, para um agente e canal específicos, a mesma entre conversas. Essa estabilidade é o ponto central.
Por que uma caixa de ferramentas estável é barata
Uma lista estável de ferramentas permitidas ajuda o provedor a reutilizar conteúdo em cache quando a API e o modelo oferecem suporte. As definições continuam contando como tokens. Cache e cobranças variam por provedor e modelo; consulte os registros e o console do provedor em vez de presumir um desconto fixo.
IA incluída usa créditos REDA. Traga sua própria IA usa a conta de provedor da sua organização, cobrada diretamente pelo provedor. A licença define um modelo para toda a organização. Nos dois, o REDA AI governa ferramentas e ações configuradas no Salesforce. Configure a licença e as contas de IA.
As alavancas de custo reais
| Alavanca | Onde | O que faz |
|---|---|---|
| Não atribua demais | Máx. de ferramentas na Definição de Agente; exclusões do Edit Loadout | A ferramenta mais barata é a que o agente não carrega. Enxugue a caixa de ferramentas para o que o agente realmente usa. |
| Modo de ferramentas | Definição de Agente | Somente páginas de registro evita carregar ferramentas nas páginas iniciais e de lista, onde o agente não tem um registro sobre o qual agir. |
| Esquemas enxutos | Definições de ferramenta personalizadas | Um esquema de entrada extenso custa tokens em cada turno e produz chamadas de ferramenta piores. Mantenha as descrições concisas e os campos no mínimo. |
| Mantenha a lista estável | Disciplina de configuração | Cada mudança na caixa de ferramentas de um agente invalida o cache do provedor para aquele agente. Agrupe as mudanças de ferramentas em vez de ajustá-las diariamente. |
Consulte Otimização do uso de créditos para o conjunto mais amplo de técnicas de custo: orçamentos de tokens, orçamentos de histórico, níveis de processamento e cache.
O campo legado Nível da ferramenta
As Definições de ferramenta ainda carregam um campo Nível da ferramenta. Ele está obsoleto: mantido para que as configurações existentes continuem sendo salvas sem erros, mas ignorado pelo motor em todas as versões atuais. Defini-lo não muda nada. Se você documentou procedimentos internos em torno do comportamento de Nível 1 / Nível 2, aposente-os — o modelo de carregamento descrito acima é a história completa.
Boas práticas
- Audite esquemas grandes. Se o esquema de entrada de uma ferramenta personalizada é extenso, pergunte-se se ele precisa ser. Um esquema mais enxuto é mais barato em cada turno e produz melhores chamadas de ferramenta.
- Não atribua demais. Ferramentas atribuídas custam tokens em cada turno. A maior economia é uma caixa de ferramentas menor, via Máx. de ferramentas e as exclusões do Edit Loadout.
- Verifique com o Depurador de conversas. O Depurador mostra a lista exata de ferramentas que o modelo viu em cada turno — use-o para confirmar que a caixa de ferramentas é a que você pretendia (é a mesma lista em todos os turnos).
Perguntas frequentes
Uma lista estável de ferramentas permitidas ajuda o provedor a reutilizar conteúdo em cache quando a API e o modelo oferecem suporte. As definições continuam contando como tokens. Cache e cobranças variam por provedor e modelo; consulte os registros e o console do provedor em vez de presumir um desconto fixo.
Não. Qualquer valor de Nível que você tenha definido é simplesmente ignorado. Suas alavancas de custo hoje são o Máx. de ferramentas, as exclusões de ferramentas por agente (Edit Loadout na Pré-visualização de Execução do Agente), o Modo de ferramentas e manter enxutos os esquemas das ferramentas personalizadas.
Enxugue a caixa de ferramentas: reduza o Máx. de ferramentas ou exclua as ferramentas que o agente nunca usa (Edit Loadout), defina o Modo de ferramentas como Somente páginas de registro se o agente só trabalha em registros, enxugue esquemas extensos de ferramentas personalizadas e mantenha a lista de ferramentas estável — cada mudança na lista invalida o cache do provedor para aquele agente.
Não. O carregamento de ferramentas é um mecanismo de economia de tokens, não um limite de segurança. Cada ferramenta é executada com CRUD, segurança no nível do campo e compartilhamento aplicados (sujeito ao Contexto de execução do agente no canal API). Para restringir uma ferramenta de um canal ou de um agente, use os campos Canais e Agente da Definição de ferramenta.
Próximos passos
Leia Otimização de uso de créditos para o conjunto completo de técnicas para manter baixo o consumo de créditos, ou revisite a Referência de Ferramentas Nativas para ver os inputs e os canais de cada ferramenta.