improve_content

Instructions

Implementation Reference

• src/server.ts:61-72 (registration)

  Registration of the 'improve_content' tool in the ListTools response, including name, description, and input schema definition.

  {
    name: 'improve_content',
    description: 'Melhora título e descrição de um curso seguindo boas práticas',
    inputSchema: {
      type: 'object',
      properties: {
        title: { type: 'string', description: 'Título atual do curso' },
        description: { type: 'string', description: 'Descrição atual do curso' },
      },
      required: ['title', 'description'],
    },
  },

• src/server.ts:135-152 (handler)

  Primary handler function for executing the 'improve_content' tool logic. Extracts input args, invokes curation service, and formats JSON response with title and description improvements.

  private async handleImproveContent(args: any) {
    const { title, description } = args;
    const content = { title, description };
    const result = await this.curationService.curateCourse(content);
    
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({
            titleImprovement: result.titleImprovement,
            descriptionImprovement: result.descriptionImprovement,
            aiEnabled: this.curationService.getAIStatus().enabled
          }, null, 2),
        },
      ],
    };
  }

• src/services/ai.service.ts:119-166 (helper)

  Core helper function implementing AI-powered title improvement using OpenAI GPT with a tailored prompt for course title best practices.

  async improveTitleWithAI(title: string, description: string): Promise<{
    suggestion: string;
    reasoning: string;
    improvements: string[];
  } | null> {
    if (!this.enabled) return null;
  
    try {
      const prompt = `
        Analise e melhore o seguinte título de curso:
  
        TÍTULO ATUAL: ${title}
        DESCRIÇÃO: ${description}
  
        Considere as boas práticas:
        - Comprimento ideal: 30-60 caracteres
        - Incluir nível (iniciante, intermediário, avançado)
        - Usar palavras-chave relevantes
        - Ser específico e claro
        - Usar números quando apropriado
  
        Responda em formato JSON:
        {
          "suggestion": "título_melhorado",
          "reasoning": "explicação_das_mudanças",
          "improvements": ["lista", "de", "melhorias", "aplicadas"]
        }
  
        Se o título já estiver bom, mantenha similar mas otimizado.
      `;
  
      const response = await this.openai.chat.completions.create({
        model: this.AIMODEL,
        messages: [{
          role: 'user',
          content: prompt
        }],
        temperature: 0.4,
        max_tokens: 250
      });
  
      const result = JSON.parse(response.choices[0].message.content || '{}');
      return result;
    } catch (error) {
      console.error('Error in AI title improvement:', error);
      return null;
    }
  }

• src/services/ai.service.ts:168-214 (helper)

  Core helper function implementing AI-powered description improvement using OpenAI GPT with best practices prompt for course descriptions.

  async improveDescriptionWithAI(title: string, description: string): Promise<{
    suggestion: string;
    reasoning: string;
    improvements: string[];
  } | null> {
    if (!this.enabled) return null;
  
    try {
      const prompt = `
        Melhore a seguinte descrição de curso:
  
        TÍTULO: ${title}
        DESCRIÇÃO ATUAL: ${description}
  
        Boas práticas para descrições:
        - Comprimento ideal: 100-300 caracteres
        - Começar com benefício/resultado
        - Usar verbos de ação (aprenda, domine, desenvolva)
        - Incluir o que será aprendido
        - Call-to-action sutil
        - Linguagem clara e envolvente
  
        Responda em formato JSON:
        {
          "suggestion": "descrição_melhorada",
          "reasoning": "explicação_das_mudanças",
          "improvements": ["lista", "de", "melhorias", "aplicadas"]
        }
      `;
  
      const response = await this.openai.chat.completions.create({
        model: this.AIMODEL,
        messages: [{
          role: 'user',
          content: prompt
        }],
        temperature: 0.4,
        max_tokens: 350
      });
  
      const result = JSON.parse(response.choices[0].message.content || '{}');
      return result;
    } catch (error) {
      console.error('Error in AI description improvement:', error);
      return null;
    }
  }

• src/services/curation.service.ts:32-55 (helper)

  Service method invoked by the handler that coordinates category/tag suggestions and content improvements, calling specific improveTitle and improveDescription methods.

  async curateCourse(content: CourseContent): Promise<CurationSuggestion> {
    if (!this.aiService.isEnabled()) {
      throw new Error('OpenAI API key is required. Please set OPENAI_API_KEY environment variable.');
    }
  
    const [
      suggestedCategory,
      suggestedTags,
      titleImprovement,
      descriptionImprovement
    ] = await Promise.all([
      this.suggestCategory(content),
      this.suggestTags(content),
      this.config.enableTitleSuggestions ? this.improveTitle(content.title, content.description) : Promise.resolve(undefined),
      this.config.enableDescriptionSuggestions ? this.improveDescription(content.title, content.description) : Promise.resolve(undefined)
    ]);
  
    return {
      suggestedCategory,
      suggestedTags,
      titleImprovement,
      descriptionImprovement
    };
  }