Carga y costo de herramientas
Cómo funciona la carga de herramientas
En cada llamada al modelo, la plataforma ensambla la caja de herramientas del agente a partir de las Definiciones de herramienta activas y la envía con la solicitud. Una herramienta entra en la lista cuando pasa todos estos filtros:
- Activa — la Definición de herramienta está marcada como activa.
- Ámbito de agente — las herramientas integradas están disponibles para todos los agentes; una herramienta personalizada puede limitarse a un agente concreto mediante su campo Agente.
- Canal — la selección de Canales de la herramienta incluye el canal en el que se ejecuta la conversación.
- Contexto — si la herramienta especifica Objetos de contexto, el objeto del registro actual debe coincidir.
- No excluida — la herramienta no está en la lista de exclusiones de este agente (configurada con Editar carga en la Vista previa de ejecución del agente).
- Dentro de Máx. de herramientas — el ajuste Máx. de herramientas del agente (1–100, predeterminado 25) limita cuántas herramientas se ofrecen, por Orden de clasificación.
La lista resultante es la misma en cada turno de la conversación — y, para un agente y canal dados, la misma entre conversaciones. Esa estabilidad es la clave.
Por qué una caja de herramientas estable es barata
Una lista estable de herramientas permitidas facilita la reutilización del prompt en caché cuando la API y el modelo lo admiten. Las definiciones siguen contando como tokens. El tratamiento y los cargos de caché varían por proveedor y modelo; consulte los registros de uso y la consola del proveedor en lugar de asumir un descuento fijo.
IA incluida utiliza créditos REDA. Traiga su propia IA utiliza la cuenta de proveedor de su organización, facturada directamente por ese proveedor. La licencia determina un modelo para toda la organización. En ambos, REDA AI controla las herramientas y acciones configuradas en Salesforce. Configure la licencia y las cuentas de IA.
Las palancas de costo reales
| Palanca | Dónde | Qué hace |
|---|---|---|
| No asignes de más | Máx. de herramientas en la Definición de agente; exclusiones de Editar carga | La herramienta más barata es la que el agente no lleva. Recorta la caja de herramientas a lo que el agente usa de verdad. |
| Modo de herramientas | Definición de agente | Solo páginas de registro evita cargar herramientas en las páginas de inicio y de lista, donde el agente no tiene un registro sobre el que actuar. |
| Esquemas ajustados | Definiciones de herramienta personalizadas | Un esquema de entrada extenso cuesta tokens en cada turno y produce peores llamadas a herramientas. Mantén las descripciones concisas y los campos al mínimo. |
| Mantén la lista estable | Disciplina de configuración | Cada cambio en la caja de herramientas de un agente invalida la caché del proveedor para ese agente. Agrupa los cambios de herramientas en lugar de retocarlas a diario. |
Consulta Optimización del uso de créditos para el conjunto más amplio de técnicas de costo: presupuestos de tokens, presupuestos de historial, niveles de procesamiento y caché.
El campo heredado Nivel de herramienta
Las Definiciones de herramienta aún llevan un campo Nivel de herramienta. Está obsoleto: se conserva para que las configuraciones existentes sigan guardándose sin errores, pero el motor lo ignora en todas las versiones actuales. Establecerlo no cambia nada. Si documentaste procedimientos internos alrededor del comportamiento de Nivel 1 / Nivel 2, retíralos — el modelo de carga descrito arriba es toda la historia.
Prácticas recomendadas
- Audita los esquemas grandes. Si el esquema de entrada de una herramienta personalizada es extenso, pregúntate si necesita serlo. Un esquema más ajustado es más barato en cada turno y produce mejores llamadas a herramientas.
- No asignes de más. Las herramientas asignadas cuestan tokens en cada turno. El mayor ahorro es una caja de herramientas más pequeña, mediante Máx. de herramientas y las exclusiones de Editar carga.
- Verifica con el Depurador de conversaciones. El Depurador muestra la lista exacta de herramientas que vio el modelo en cada turno — úsalo para confirmar que la caja de herramientas es la que pretendías (es la misma lista en todos los turnos).
Preguntas frecuentes
Una lista estable de herramientas permitidas facilita la reutilización del prompt en caché cuando la API y el modelo lo admiten. Las definiciones siguen contando como tokens. El tratamiento y los cargos de caché varían por proveedor y modelo; consulte los registros de uso y la consola del proveedor en lugar de asumir un descuento fijo.
No. Cualquier valor de Nivel que hayas establecido simplemente se ignora. Tus palancas de costo hoy son Máx. de herramientas, las exclusiones de herramientas por agente (Editar carga en la Vista previa de ejecución del agente), el Modo de herramientas y mantener ajustados los esquemas de las herramientas personalizadas.
Recorta la caja de herramientas: baja Máx. de herramientas o excluye las herramientas que el agente nunca usa (Editar carga), establece el Modo de herramientas en Solo páginas de registro si el agente solo trabaja sobre registros, ajusta los esquemas extensos de herramientas personalizadas y mantén la lista de herramientas estable — cada cambio en la lista invalida la caché del proveedor para ese agente.
No. La carga de herramientas es un mecanismo de economía de tokens, no un límite de seguridad. Cada herramienta se ejecuta con CRUD, seguridad a nivel de campo y colaboración aplicados (sujeto al Contexto de ejecución del agente en el canal API). Para restringir una herramienta de un canal o un agente, usa los campos Canales y Agente de la Definición de herramienta.
Próximos pasos
Lee Optimización del uso de créditos para conocer el conjunto completo de técnicas que mantienen bajo el consumo de créditos, o vuelve a la Referencia de herramientas integradas para ver las entradas y los canales de cada herramienta.