GmailToolkit
GmailToolkit da a un agente un conjunto de herramientas para trabajar con tu cuenta de Gmail: enviar y responder correos, crear borradores, buscar y leer mensajes, y organizar la bandeja con etiquetas, marcas de leído y papelera. El agente decide cuándo usar cada herramienta durante la conversación.
Cuándo usarlo
- Un asistente que lee los correos de un cliente y le responde.
- Clasificar los correos entrantes con etiquetas.
- Enviar un informe por correo, con el contenido adjunto como PDF.
- Buscar correos antiguos de un proveedor y resumirlos.
Configuración
Necesitas una credencial Google Gmail, que se conecta iniciando sesión con tu cuenta de Google. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Google Gmail de la cuenta con la que trabaja el agente. |
| Description | Texto descriptivo del conjunto de herramientas. Por defecto, Toolkit for gmail operations. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| From Email | El remitente que aparece en los correos enviados, con el formato Nombre <email@dominio.com>. Vacío, se usa la cuenta de la credencial. |
| CSS Style for PDF generation | El estilo (tipo de letra, márgenes, colores) de los PDF que se adjuntan al enviar un correo. |
Herramientas
| Herramienta | Qué hace |
|---|---|
send_gmail_message | Envía un correo con destinatarios, asunto, copia y copia oculta. Puede adjuntar textos, que se convierten en archivos PDF. |
create_email_draft | Crea un borrador sin enviarlo. |
reply_gmail_message | Responde a un correo concreto dentro de su conversación. |
search_email | Busca correos o conversaciones con los filtros de búsqueda de Gmail (remitente, asunto, fechas, etiqueta…). Devuelve 10 resultados por defecto. |
get_gmail_message | Lee un correo: remitente, asunto, cuerpo y, si se pide, adjuntos. |
get_gmail_thread | Lee una conversación completa. |
mark_gmail_message_read_unread | Marca correos como leídos o no leídos. |
update_gmail_label | Cambia las etiquetas de uno o varios correos. Quita las etiquetas que tenían y pone las indicadas. |
get_gmail_label | Consulta una etiqueta o lista todas. |
create_gmail_label | Crea una etiqueta. |
delete_gmail_label | Elimina una etiqueta. |
trash_or_untrash_gmail_thread | Mueve una conversación a la papelera o la recupera. |
delete_gmail_message | Elimina un correo de forma definitiva. |
delete_gmail_thread | Elimina una conversación de forma definitiva. |
Resultado
La salida BaseToolkit es el conjunto de herramientas. Conéctala al conector de herramientas de un agente.
Ejemplo
Un despacho quiere un asistente que ordene los correos de clientes.
- Añade GmailToolkit con la credencial Google Gmail del buzón del despacho.
- Conecta BaseToolkit al agente.
- En las instrucciones del agente, pide que busque los correos sin leer de hoy, ponga la etiqueta “Clientes” a los de clientes y los marque como leídos.
Buenas prácticas
- Las herramientas de eliminar correos y conversaciones borran de forma definitiva. Si no quieres que el agente borre nada, indícalo en sus instrucciones o usa un componente de Gmail con una operación concreta.
- Cambiar etiquetas sustituye las que ya tenía el correo: pide al agente que incluya todas las que deben quedarse.
- Prueba el agente con una cuenta de pruebas antes de conectarlo al buzón real.
Componentes relacionados
- Gmail Message: una operación concreta sobre correos.
- Tool Mode: cómo usa un agente las herramientas.