Skip to content

Instantly share code, notes, and snippets.

@leifermendez
Created March 14, 2025 12:02
Show Gist options
  • Save leifermendez/cc2be6c210eede30916bd520f687b328 to your computer and use it in GitHub Desktop.
Save leifermendez/cc2be6c210eede30916bd520f687b328 to your computer and use it in GitHub Desktop.
prompt-ai-builderbot.txt
Guía paso a paso para desarrollar AI Builderbot
Aquí tienes una guía clara y sencilla que puedes compartir con tu programador junior para implementar la aplicación AI Builderbot:
Fase 1: Preparación del proyecto
Crear el proyecto base
Inicia un nuevo proyecto de Next.js con soporte para React y TailwindCSS
Organiza la estructura de carpetas para separar componentes, páginas y estilos
Configuración inicial
Asegúrate de que TailwindCSS esté correctamente configurado
Establece los colores y temas principales de la aplicación
Implementa la fuente "Inter" de Google Fonts como fuente principal de toda la aplicación
Configura la fuente para que cargue correctamente en todas las páginas
Fase 2: Desarrollo de componentes principales
Crear la página principal
Diseña un layout básico con una barra de navegación superior
Implementa un área principal donde se mostrarán los archivos
Añade un botón destacado para subir nuevos archivos
Aplica la fuente Inter a todos los elementos de texto
Módulo de gestión de archivos
Crea la visualización en lista o cuadrícula de los archivos existentes
Implementa la funcionalidad para subir nuevos archivos
Añade opciones para acceder y editar el prompt de cada archivo
Módulo de ajustes
Diseña un formulario simple para guardar la configuración
Incluye campos para botId, answerId y apiToken
Implementa el guardado local de esta información
Fase 3: Funcionalidades avanzadas
Editor de prompts
Crea un editor de texto sencillo para modificar el prompt de cada archivo
Añade botones para guardar los cambios o cancelar
Visualizador de archivos
Implementa una vista previa para los archivos seleccionados
Incluye información básica como tamaño, tipo y fecha de modificación
Fase 4: Integración y pruebas
Conectar los componentes
Asegúrate de que todos los componentes funcionan juntos correctamente
Verifica que la navegación entre secciones sea intuitiva
Confirma que la fuente Inter se aplica consistentemente en toda la aplicación
Probar la aplicación
Comprueba que todas las funcionalidades (subir, listar y editar) funcionan
Verifica que los ajustes se guardan correctamente
Asegúrate de que la fuente se carga correctamente en diferentes navegadores
Fase 5: Mejoras finales
Optimizar la experiencia del usuario
Añade animaciones suaves para transiciones
Implementa mensajes de confirmación para acciones importantes
Pulir el diseño
Asegúrate de que la aplicación se ve bien en todos los tamaños de pantalla
Unifica el estilo visual en toda la aplicación usando consistentemente la fuente Inter
Considera crear variantes de peso de la fuente para títulos, subtítulos y texto normal
Documentación
Prepara una breve documentación sobre cómo usar la aplicación
Incluye instrucciones para futuras actualizaciones
Document
La documentacion de la API es la siguiente.
Plugin Assistant
Interactúa con el asistente del plugin, puedes actualizar el prompt
Parámetros del URL:
id - ID del bot (requerido)
answerId - ID de la respuesta (requerido)
Parámetros del body:
instructions - Instrucciones para el asistente (requerido)
POST/api/v2/{id}/answer/{answerId}/plugin/assistant
curl --location 'https://app.builderbot.cloud/api/v2/fc947663-5a31-49e8-b84d-09ff90eab621/answer/{answerId}/plugin/assistant' \
--header 'Content-Type: application/json' \
--header 'x-api-builderbot: bb-30778940-18eb-4943-952a-4853a2bc8cc0' \
--data '{
"instructions":"prompt"
}'
Plugin Assistant Files
Sube archivos para el asistente del plugin
Parámetros del URL:
id - ID del bot (requerido)
answerId - ID de la respuesta (requerido)
Parámetros del form:
file - Archivo a subir (requerido)
POST/api/v2/{id}/answer/{answerId}/plugin/assistant/files
curl --location 'https://app.builderbot.cloud/api/v2/fc947663-5a31-49e8-b84d-09ff90eab621/answer/{answerId}/plugin/assistant/files' \
--header 'x-api-builderbot: bb-30778940-18eb-4943-952a-4853a2bc8cc0' \
--form 'file=@"/ruta/a/tu/archivo.pdf"'
Obtener archivos del asistente:
GET/api/v2/{id}/answer/{answerId}/plugin/assistant/files
curl --location --request GET 'https://app.builderbot.cloud/api/v2/fc947663-5a31-49e8-b84d-09ff90eab621/answer/{answerId}/plugin/assistant/files' \
--header 'x-api-builderbot: bb-30778940-18eb-4943-952a-4853a2bc8cc0'
—response–
{
"files": [
{
"id": "file-WLXiPWaGsryE6P1qeM4kPG",
"object": "file",
"filename": "Explore-logs-2025-02-24 13_26_52.txt",
"purpose": "assistants",
"bytes": 7979,
"created_at": 1741800330,
"status": "processed",
"status_details": null
},
{
"id": "file-988CBsoYRvkpzdfewnB99t",
"object": "file",
"filename": "Guía de Entrevista.pdf",
"purpose": "assistants",
"bytes": 64196,
"created_at": 1741798449,
"status": "processed",
"status_details": null
}
]
}
Eliminar un archivo del asistente:
DELETE/api/v2/{id}/answer/{answerId}/plugin/assistant/files?fileId={fileId}
curl --location --request DELETE 'https://app.builderbot.cloud/api/v2/fc947663-5a31-49e8-b84d-09ff90eab621/answer/{answerId}/plugin/assistant/files?fileId={fileId}' \
--header 'x-api-builderbot: bb-30778940-18eb-4943-952a-4853a2bc8cc0'
—response–
{
"success": true,
"assistantFile": {
"id": "asst_BVoIQTMcrPOiamXs9eX3ToOa",
"object": "assistant",
"created_at": 1741725370,
"name": "assistant_4e8e4dfc-bac9-4939-9137-015b77dbd24f",
"description": null,
"model": "gpt-4o-mini",
"instructions": "Actua como un asisten de ventas builderbot",
"tools": [
{
"type": "file_search",
"file_search": {
"ranking_options": {
"ranker": "default_2024_08_21",
"score_threshold": 0
}
}
}
],
"top_p": 1,
"temperature": 0.2,
"reasoning_effort": null,
"tool_resources": {
"file_search": {
"vector_store_ids": [
"vs_67d09eba396c8191a7573ca38cf77729"
]
},
"code_interpreter": {
"file_ids": [
"file-988CBsoYRvkpzdfewnB99t"
]
}
},
"metadata": {},
"response_format": "auto"
},
"updatedAnswer": {
"options": {
"sensitive": false,
"capture": false,
"media": null,
"delay": 0,
"gotoFlow": null
},
"contentSettings": {
"split": true,
"interpretLinks": false
},
"rules": [],
"plugins": {
"chatPdf": null,
"http": null,
"openai": {
"assistantId": "asst_BVoIQTMcrPOiamXs9eX3ToOa",
"assistantName": "",
"assistantInstructions": "Actua como un asisten de ventas builderbot",
"assistantVectorStoreIds": [
"vs_67d09eba396c8191a7573ca38cf77729"
],
"assistantFileSearch": false,
"assistantInterpretMultimedia": null,
"assistantSplitParagraphs": null,
"assistantFiles": [
{
"id": "file-988CBsoYRvkpzdfewnB99t",
"object": "file",
"filename": "Guía de Entrevista.pdf",
"purpose": "assistants",
"bytes": 64196,
"created_at": 1741798449,
"status": "processed",
"status_details": null
}
]
},
"shopify": null,
"mute": null,
"schedule": null,
"intent": null,
"voice": null,
"reminder": null
},
"id": "4e8e4dfc-bac9-4939-9137-015b77dbd24f",
"uuid": "4e8e4dfc-bac9-4939-9137-015b77dbd24f",
"message": "Conectar con ChatPDF",
"type": "add_chatpdf",
"sort": 1,
"ref": "",
"cb": "",
"deletedAt": null,
"flowId": "67cb4957c58c962a26ec54cd",
"botId": "fc947663-5a31-49e8-b84d-09ff90eab621",
"createdAt": "2025-03-11T20:36:05.243Z",
"updatedAt": "2025-03-13T20:18:16.086Z"
}
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment