> ## Documentation Index > Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt > Use this file to discover all available pages before exploring further. # Generar Agente con Prompt > Genera la configuracion completa de un Agente de IA a partir de un unico prompt descriptivo en lenguaje natural. El sistema analiza el texto, detecta automaticamente el tipo de negocio y genera un JSON listo para crear el agente con POST /api/agent/add. Mientras mas detallado sea el prompt, mejor sera la configuracion generada. Si se proporciona poca informacion, el sistema deduce valores razonables por defecto. ## OpenAPI ````yaml POST /api/agent/ai-builder-prompt openapi: 3.1.0 info: title: Plazbot description: >- Documentacion completa de la API de Plazbot. Incluye todos los servicios para gestion de contactos, conversaciones, mensajes, oportunidades, tareas, plantillas, agentes de IA, usuarios y workspaces. license: name: MIT version: 1.0.0 servers: - url: https://api.plazbot.com description: Servidor de produccion de Plazbot security: - bearerAuth: [] tags: - name: automation description: Servicios de automatizacion y nodos de IA - name: agent description: Servicios para gestion de Agentes de Inteligencia Artificial - name: contact description: Servicios para gestion de contactos del workspace - name: conversation description: Servicios para gestion de conversaciones y campanas - name: message description: Servicios para envio y gestion de mensajes - name: opportunity description: Servicios para gestion de oportunidades de negocio - name: task description: Servicios para gestion de tareas - name: template description: Servicios para gestion de plantillas de WhatsApp - name: user description: Servicios para gestion de usuarios y autenticacion - name: workspace description: Servicios para gestion de workspaces paths: /api/agent/ai-builder-prompt: post: tags: - agent summary: Generar Agente con Prompt description: >- Genera la configuracion completa de un Agente de IA a partir de un unico prompt descriptivo en lenguaje natural. El sistema analiza el texto, detecta automaticamente el tipo de negocio y genera un JSON listo para crear el agente con POST /api/agent/add. Mientras mas detallado sea el prompt, mejor sera la configuracion generada. Si se proporciona poca informacion, el sistema deduce valores razonables por defecto. operationId: aiBuilderPrompt parameters: - name: x-workspace-id in: header description: Identificador del workspace required: true schema: type: string requestBody: required: true content: application/json: schema: type: object properties: prompt: type: string description: >- Descripcion en lenguaje natural del agente que necesitas crear. Incluye tipo de negocio, nombre, proposito, canales, tono, idioma, y cualquier detalle relevante. example: >- Necesito un agente para mi clinica dental DentalSmile en Lima Peru, que agende citas, confirme y cancele citas, horario lunes a viernes 9am a 6pm, tono amable y profesional, en español, canal whatsapp, si no puede resolver que derive a un humano required: - prompt responses: '200': description: Configuracion del agente generada exitosamente content: application/json: schema: type: object properties: success: type: boolean description: Indica si la generacion fue exitosa example: true config: type: object description: >- JSON completo de configuracion del agente, listo para usar con POST /api/agent/add properties: name: type: string description: Nombre del agente example: Asistente DentalSmile description: type: string description: Descripcion del agente prompt: type: string description: System prompt generado para el agente zone: type: string enum: - LA - EU description: Zona geografica timezone: type: string description: Zona horaria IANA example: America/Lima buffer: type: integer description: Cantidad de mensajes en buffer example: 8 instructions: type: object description: Instrucciones de tono, personalidad, idioma, etc. person: type: object description: Persona del agente (nombre, rol) fallbacks: type: object description: Respuestas predeterminadas actions: type: array description: Acciones internas (citas, tags, escalacion) services: type: array description: Conexiones a APIs externas channels: type: array description: Canales habilitados useToolCalling: type: boolean description: Habilitar tool calling aiProviders: type: array description: Proveedores de IA configurados usage: type: object description: Tokens consumidos en la generacion properties: input_tokens: type: integer description: Tokens de entrada consumidos example: 1847 output_tokens: type: integer description: Tokens de salida consumidos example: 623 '400': description: >- Solicitud incorrecta - Prompt vacio o no se pudo generar la configuracion content: application/json: schema: type: object properties: success: type: boolean example: false message: type: string example: El campo 'prompt' es requerido. error: type: string example: >- No se pudo generar la configuracion del agente. Intenta con un prompt mas descriptivo. usage: type: object properties: input_tokens: type: integer output_tokens: type: integer '401': description: No autorizado - Token Bearer requerido o invalido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: ErrorResponse: type: object description: Respuesta de error estandar de la API properties: success: type: boolean description: Siempre false en errores code: type: integer description: Codigo HTTP del error errorCode: type: - string - 'null' description: Codigo de error especifico message: type: string description: Mensaje descriptivo del error required: - success - code - message securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Token de autenticacion Bearer. Obtenga el token usando el endpoint /api/user/login ````