Herramientas propias

Deja que el asistente actúe en tu app

Dale a tu asistente de Masheev herramientas con tipos que pueda llamar durante una conversación. Se ejecutan en tu app, pueden devolver una tarjeta o respuestas rápidas y pueden esperar a que la persona las apruebe. Las herramientas de cliente funcionan en el chat web.

Empezar prueba de 14 días Resumen para desarrolladores

Desde $18/mes para todo tu equipo después de la prueba. Tarjeta requerida. Sin cargo si cancelas dentro de los 14 días. Disponible para empresas del Reino Unido y Estados Unidos.

¿Qué son las herramientas de agentes de IA (function calling)?

Las herramientas son funciones que le das al asistente para que pueda actuar además de responder. Durante una conversación decide cuándo hace falta una herramienta, la llama con argumentos validados y usa el resultado para continuar: consultar un pedido, reservar un hueco o actualizar un registro.

En Masheev defines herramientas de cliente con el helper clientTool, con tipos mediante Zod o JSON Schema. Su función execute se ejecuta en tu app y puede devolver texto, una tarjeta o respuestas rápidas, con aprobación opcional para las acciones sensibles. El agente también puede usar acciones del lado del servidor e integraciones conectadas en el backend.

La herramienta, línea a línea

Tres bloques de código. Eso es una herramienta.

import { clientTool, useMasheev } from "@masheev/embed-sdk/react";
import { z } from "zod";

const checkOrder = clientTool({
  name: "check_order_status",
  description: "Look up the status of a customer's order",
  parameters: z.object({ orderId: z.string() }),
  needsApproval: false,

Con tipos mediante Zod o JSON Schema

Define el nombre, la descripción y los parámetros de una herramienta con Zod o JSON Schema simple. El asistente la llama con argumentos validados.

  execute: async ({ orderId }) => {
    const order = await myApi.getOrder(orderId);
    return {
      success: true,
      display: "card",
      components: {
        card: {
          title: `Order ${order.id}`,
          fields: [{ label: "Status", value: order.status }],
        },
      },
    };
  },
});

Se ejecuta en tu app

Tu función execute se ejecuta en el navegador. Puede llamar a tu API, consultar un registro o reservar un hueco, y luego devolver el resultado a la conversación.

```
// Pass tools to the assistant
useMasheev({ inboxId: "inb_123", tools: [checkOrder] });
```
3
Entrégasela al asistente
Pasa tus herramientas a useMasheev o actualízalas durante una sesión. El asistente las llama cuando son relevantes.

Aprobación

Pregunta primero.

ClienteQuiero devolver esto.
AsistenteInicio la devolución del pedido 1042. ¿Confirmas?
Tu appexecute() solo se ejecuta cuando el cliente confirma.

Aprobación antes de ejecutarse: Activa needsApproval en una herramienta y la persona confirma antes de que se ejecute. Úsalo para todo lo que cambie datos o cueste dinero.
Los resultados son datos, no instrucciones: Los resultados de las herramientas se sanean y se pasan al modelo como datos, con límites de tamaño y de frecuencia, lo que protege frente a la inyección de prompts.

Ejemplo ilustrativo

Más

Qué más puede hacer una herramienta.

Devuelve tarjetas y respuestas rápidas

Un resultado puede aparecer como texto, como una tarjeta estructurada o como botones de respuesta rápida, para que las personas vean el pedido o la reserva en sí y no un párrafo sobre ellos.

Acciones del lado del servidor

Junto a las herramientas de cliente, el agente puede usar acciones del lado del servidor e integraciones conectadas, como calendarios, desde el backend.

Todavía noConectar tus propias API desde el servidor, y herramientas fuera del chat web.

Tu app hace el trabajo.

Preguntas frecuentes

¿Qué son las herramientas de agentes de IA?

Las herramientas, también llamadas function calling, son funciones que le das al asistente para que pueda actuar además de responder. Durante una conversación decide cuándo llamar a una herramienta, envía argumentos validados y usa el resultado para continuar. En Masheev, las herramientas de cliente se ejecutan en tu app y las acciones del lado del servidor, en el backend.

¿Cómo defino una herramienta?

Usa el helper clientTool con un nombre, una descripción y un esquema de parámetros (Zod o JSON Schema), más una función execute que haga el trabajo y devuelva un resultado. Pasa tus herramientas a useMasheev o actualízalas durante una sesión. El asistente las llama cuando son relevantes.

¿Puede una herramienta exigir aprobación antes de ejecutarse?

Sí. Activa needsApproval en la herramienta y la persona deberá confirmar antes de que se ejecute tu función execute. Úsalo para acciones que cambien datos, hagan pedidos o cuesten dinero.

¿Pueden las herramientas mostrar una interfaz rica, no solo texto?

Sí. El resultado de una herramienta puede mostrarse como texto simple, como una tarjeta estructurada (título, subtítulo y campos con etiqueta) o como botones de respuesta rápida dentro de la conversación.

¿Cómo se protegen las herramientas?

Los resultados de las herramientas se sanean y se tratan estrictamente como datos, no como instrucciones para el modelo, lo que protege frente a la inyección de prompts. Los datos devueltos tienen límites de tamaño, las llamadas tienen límite de frecuencia y las acciones sensibles pueden exigir aprobación.

Sigue leyendo

Dale algo que hacer al asistente

Define herramientas con tipos, decide cuáles necesitan aprobación y deja que el asistente se ocupe de las consultas y las reservas.

Empezar prueba de 14 días Habla con el equipo