Communitygithub.com

jubsnfzm/iris-plugin

Configura o gestiona Iris (el agente de IA de Flowlith para chats de Instagram, WhatsApp, Messenger y sitio web de una empresa). Úsalo cuando el usuario quiera incorporar su negocio a Iris, verificar su estado, cambiar lo que Iris sabe, enseñarle, lanzarlo, probarlo o comprar créditos.

¿Qué es iris-plugin?

Esta habilidad sirve para configurar y gestionar el agente de IA Iris de Flowlith, el cual atiende conversaciones de clientes a través de Instagram, WhatsApp, Messenger y el sitio web de la empresa. Permite incorporar un negocio nuevo mediante un proceso de onboarding paso a paso, donde se recopilan datos del negocio y del propietario, se definen los canales de atención y se aceptan términos legales. También facilita la conexión de canales y la compra de créditos a través de enlaces de pago externos, sin necesidad de manejar datos sensibles como tarjetas o tokens. Además, gestiona las habilidades específicas de Iris para tareas concretas (como responder preguntas sobre entregas), permitiendo configurarlas, previsualizarlas y guardarlas solo con la aprobación del usuario. Finalmente, una vez lanzado el agente, se ofrece la posibilidad de probarlo con preguntas reales de clientes. Está diseñada para ser utilizada en consolas de IA como Claude Code, Cursor o Codex, manteniendo respuestas cortas y claras.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jubsnfzm/iris-plugin/tree/HEAD/skills/iris-setup

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Configuración de Iris

El servidor MCP iris realiza el trabajo; esta habilidad es la forma de comunicarse con el propietario mientras se utiliza.

  1. Llama primero a list_businesses.
    • Sin negocio: ejecuta la incorporación (paso 2).
    • Tiene uno: llama a get_business_status y recorre sus next_steps.
  2. Incorporación: llama a get_onboarding_questions y luego recórrelo como una conversación.
    • Pregunta el nombre del negocio, ubicación y sitio web; luego el nombre del propietario y cómo debe contactarlo Flowlith (WhatsApp con código de país o un nombre de usuario de LinkedIn).
    • Haz cada pregunta de configuración una a la vez. Muestra las opciones como una lista numerada corta, menciona max_choices cuando esté configurado y ofrece la pista de seguimiento como opcional adicional.
    • Guarda después de cada respuesta con save_onboarding_answers. Asigna los números que el propietario escriba al texto de la opción; coloca cualquier cosa en sus propias palabras en details.
    • Pregunta dónde debe responder Iris a los clientes (channels).
    • Resume todo. Comparte https://www.flowlith.com/terms y https://www.flowlith.com/privacy. Llama a submit_onboarding solo después de que el propietario acepte claramente.
  3. Pasos del navegador: connect_channel devuelve un enlace al panel de control. buy_credits devuelve un enlace de pago de Razorpay (válido 24 horas) para un paquete o el plan mensual. Entrega el enlace, espera a que el propietario diga que ha terminado, luego verifica get_business_status o get_credits. Los créditos pueden tardar un minuto en aparecer. Nunca pidas números de tarjeta, PIN de UPI, contraseñas ni tokens de Meta.
  4. Habilidades (cómo maneja Iris un trabajo específico, por ejemplo, preguntas sobre entregas):
    • Llama a get_skill_questions, haz cada pregunta UNA a la vez, luego llama a preview_skill y pregunta lo que falte según la respuesta.
    • Muestra la vista previa completa al propietario. Guarda con save_skill y el preview_id de la vista previa solo después de que apruebe; cualquier cambio necesita una nueva vista previa.
    • Nunca inventes reglas, precios ni promesas. Si el servidor rechaza texto (un secreto o algo inseguro), explica por qué y ayuda a reformular.
    • Documentos y claves API para una habilidad: envía el enlace teach de la página open_dashboard. Los ajustes, la memoria del cliente, las claves API del sitio web, la exportación de datos y la eliminación de cuentas son solo desde el navegador: envía el enlace open_dashboard correspondiente.
  5. Pregunta antes de cambiar algo que los clientes verán: update_business_info (muestra primero el texto nuevo), launch_agent, save_skill, remove_skill.
  6. Después del lanzamiento, ofrece test_agent con una pregunta realista de un cliente. Menciona que consume 1 crédito.

Mantén las respuestas cortas y sencillas. Si una herramienta devuelve un error, explícalo en una frase y di qué hacer a continuación.

Skills relacionados