Descripción de las herramientas

Las herramientas habilitan las acciones de la IA Las herramientas son el puente entre el agente de IA y tu organización de Salesforce. Le permiten al agente recuperar, consultar y modificar datos de forma activa durante las conversaciones.

¿Qué son las herramientas?

Las herramientas en REDA AI son integraciones prediseñadas que permiten al agente de IA interactuar con Salesforce. Sin herramientas, la IA solo puede ofrecer sugerencias basadas en prompts y contexto estático. Con herramientas, la IA puede consultar registros, crear datos nuevos, actualizar campos y realizar acciones de forma activa.

Internamente, las herramientas se definen como registros de metadatos personalizados. REDA AI incluye un amplio conjunto de herramientas integradas que cubren las operaciones habituales de Salesforce, las cuales asignas a tus agentes según sea necesario. Cuando una herramienta integrada no cubre lo que necesitas, también puedes crear tu propia herramienta personalizada; consulta Configuración de herramientas.

Dos categorías de herramientas

Categoría	Valor del campo	Capacidad	Ejemplos
Herramienta (solo lectura)	Tool	Consultar datos de Salesforce sin cambiar nada	soql_query, get_record, count_records, describe_object, get_picklist_values, get_record_types
Acción (lectura y escritura)	Action	Crear, actualizar o eliminar registros, o activar acciones	create_record, update_record, delete_record, send_email, create_task, create_event, schedule_action, link_file_to_record, send_custom_notification

Herramientas listas para usar más comunes

Nombre de la herramienta	Categoría	Propósito
soql_query	Tool	Consultar registros con SOQL, con filtros, ordenamiento y selección de campos
get_record	Tool	Recuperar un único registro por ID y devolver todos los campos accesibles
count_records	Tool	Contar registros que cumplen ciertos criterios (por ejemplo, “¿cuántos casos abiertos hay?”)
describe_object	Tool	Obtener metadatos de un objeto de Salesforce (nombres de campos, tipos, relaciones)
get_picklist_values	Tool	Obtener los valores de lista de selección de un campo específico
get_record_types	Tool	Obtener los tipos de registro disponibles para un objeto
create_record	Action	Crear un nuevo registro de Salesforce con valores de campo específicos
update_record	Action	Actualizar campos específicos de un registro existente
delete_record	Action	Eliminar un registro (se mueve a la papelera de reciclaje)
send_email	Action	Enviar un correo desde el usuario a los destinatarios especificados
create_task	Action	Crear un nuevo registro de tarea
create_event	Action	Crear un evento de calendario
schedule_action	Action	Programar una acción futura (se ejecuta sin confirmación)
link_file_to_record	Action	Adjuntar un archivo cargado a un registro de Salesforce
send_custom_notification	Action	Enviar una notificación personalizada de Salesforce a los usuarios especificados

Capacidades adicionales

Además de las herramientas mencionadas arriba, los agentes de REDA AI también pueden usar Búsqueda web (buscar en internet información en tiempo real) y Carga de archivos (procesar documentos, imágenes y datos CSV cargados). Estas capacidades se habilitan por agente en la Definición de agente; consulta sus páginas específicas para más detalles.

Cómo decide la IA llamar a las herramientas

Cuando un usuario envía un mensaje, la IA lo procesa de la siguiente manera:

La IA recibe el mensaje
El usuario hace una pregunta o solicita una acción.
La IA analiza las herramientas disponibles
La IA revisa la lista de herramientas asignadas a este agente.
La IA decide si necesita una herramienta
Según la pregunta del usuario, la IA decide si llamar a una herramienta sería útil. Ejemplo: "Para responder esta pregunta, necesito consultar las oportunidades de esta cuenta" → llama a soql_query.
La IA construye la llamada a la herramienta
La IA formula los parámetros necesarios. Ejemplo: soql_query(object="Oportunidad", filters={"AccountId": "001xx000003DHP"})
REDA AI ejecuta la herramienta
REDA AI intercepta la llamada a la herramienta, valida los permisos y la ejecuta contra Salesforce.
Los resultados se devuelven a la IA
El resultado de la herramienta se envía de vuelta a la IA. Ejemplo: [{"Id": "006xx000001SMeAAM", "StageName": "Negotiation/Review", "Amount": 50000}, ...]
La IA formula la respuesta
La IA usa el resultado de la herramienta para responder la pregunta original del usuario con datos específicos.

Las herramientas de tipo Acción requieren confirmación

En el canal interno, antes de ejecutar una herramienta de Acción cuyo Requires Confirmation esté activado (create_record, send_email, update_record y otras cuatro), el agente muestra una tarjeta de confirmación al usuario. La tarjeta de confirmación muestra:

Qué acción se realizará (por ejemplo, "Crear tarea")
Los valores de los campos clave que se establecerán (por ejemplo, Asunto, Fecha de vencimiento, Prioridad)
Un botón "Confirmar" para continuar o un botón "Cancelar" para abortar

Esto evita cambios accidentales en los datos. El usuario debe aprobar de forma consciente cada acción antes de que se ejecute.

Dos límites a eso. Tres herramientas de Acción tienen Requires Confirmation desactivado y nunca muestran tarjeta: schedule_action, link_file_to_record y continue_workflow. Y las tarjetas existen solo en el canal interno: en el widget externo y en Comunidad el agente ejecuta la acción y luego narra el resultado, y en el canal de API lo decide un Flujo mediante Auto Execute Actions. Consulta Confirmaciones de acción.

REDA AI respeta el modelo de seguridad de Salesforce. Cuando la IA llama a una herramienta:

Seguridad a nivel de campo (FLS) — La IA solo puede acceder a los campos a los que el usuario en ejecución tiene acceso de lectura o escritura. Los campos a los que el usuario no puede acceder quedan excluidos.
Permisos a nivel de objeto — La IA solo puede consultar o crear registros en los objetos a los que el usuario tiene acceso.
Colaboración de registros — La IA solo puede acceder a los registros compartidos con el usuario mediante reglas de colaboración, valores predeterminados de toda la organización o la jerarquía de roles.
Una excepción deliberada: un agente cuyo Contexto de ejecución sea Sistema y cuyo Canal sea API lee campos que el usuario en ejecución no puede ver. Aun así, la colaboración de registros nunca se amplía: ve más campos de registros que ya podía alcanzar. En todo lo demás, REDA AI opera estrictamente como el usuario que inició sesión. Consulta Seguridad de los datos.

Esto significa que un agente de IA es tan seguro como el usuario que lo ejecuta. Un agente de soporte al que accede un usuario de un portal de clientes solo puede ver y modificar los registros compartidos con ese usuario del portal.

Las herramientas integradas se administran mediante el paquete

Las herramientas integradas mencionadas arriba se definen como registros de metadatos personalizados administrados por el paquete de REDA AI. Esto significa que:

No puedes editar ni eliminar la definición de una herramienta integrada; solo puedes asignarla a agentes o dejarla sin asignar
El conjunto de herramientas integradas se actualiza cada vez que se actualiza el paquete de REDA AI
Las definiciones de las herramientas integradas son de solo lectura en tu organización
Configuras qué herramientas usar asignándolas a los agentes

Cuando una herramienta integrada no cubre lo que necesitas, crea una herramienta personalizada en su lugar: una herramienta de plantilla SOQL, clase Apex o mapeo de archivos, en el Generador de herramientas. Consulta Configuración de herramientas para conocer el recorrido completo.

Asignación de herramientas a los agentes

No usas todas las herramientas en todos los agentes. En cambio:

Abre la Definición de agente
Busca la lista relacionada "Herramientas"
Haz clic en "Agregar herramienta"
Selecciona solo las herramientas que este agente necesita
Guarda

Solo las herramientas asignadas están disponibles para el agente. La IA nunca sugiere herramientas sin asignar.

Costo en tokens de las herramientas

Cada herramienta disponible para el agente consume tokens en cada solicitud. Incluso si la herramienta no se llama, su definición se incluye en el contexto enviado a la IA. Esto significa que:

Asigna solo las herramientas que el agente realmente necesita
Elimina las herramientas que no se usan para ahorrar tokens y reducir costos
Una configuración de la plataforma controla cuándo se cargan las herramientas: siempre, o solo en las páginas de registro

Por ejemplo, eliminar herramientas innecesarias de un agente reduce notablemente el consumo de tokens por solicitud, lo que disminuye directamente tus costos de créditos. Consulta Carga y costo de herramientas para ver cómo la lista de herramientas estable y en caché del proveedor mantiene bajo el costo restante.

Preguntas frecuentes

Sí. Las herramientas integradas que incluye el paquete de REDA AI son de solo lectura, pero puedes crear tu propia herramienta de plantilla SOQL, clase Apex o mapeo de archivos en el Generador de herramientas cuando las integradas no cubran tu caso de uso. Consulta Configuración de herramientas para conocer el recorrido completo.

La llamada a la herramienta falla con un error de permisos. La IA recibe el error y normalmente informa al usuario con un mensaje como "No tienes permiso para acceder a estos datos" o similar. El error no interrumpe la conversación; la IA puede sugerir alternativas o pedir más información.

No. schedule_action es único porque se ejecuta de forma silenciosa, sin una tarjeta de confirmación. Esto se debe a que programa una acción futura en lugar de modificar los datos de inmediato, y las acciones futuras programadas puede cancelarlas el usuario después si es necesario.

Piensa en lo que el agente necesita hacer. Si es un agente de ventas, probablemente necesite soql_query, create_task, create_event, send_email. Si es un agente de referencia de solo lectura, quizá solo le asignes soql_query y describe_object. Usa "Crear un agente con IA" para obtener recomendaciones.

Próximos pasos

Aprende a configurar herramientas para tus agentes, o explora las tarjetas de confirmación de acciones para entender cómo los usuarios aprueban los cambios en los datos.

Siguiente: Configuración de herramientas →