Link insertion

CHANGELOG.md

@@ -14,6 +14,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [0.0.8] - 2025-11-14
+### Changed
+- Disabled thinking for Google Models
+
 ## [0.0.8] - 2025-11-12
 ### Changed
 - Navbar spacing rules

core/agents/__init__.py

@@ -12,14 +12,13 @@
 from core.agents.generate_blog_post_content_agent import (
     create_generate_blog_post_content_agent,
 )
+from core.agents.insert_internal_links_agent import create_insert_internal_links_agent
 from core.agents.populate_competitor_details_agent import (
     create_populate_competitor_details_agent,
 )
 from core.agents.summarize_page_agent import create_summarize_page_agent
 from core.agents.title_suggestions_agent import create_title_suggestions_agent
-from core.agents.validate_blog_post_ending_agent import (
-    create_validate_blog_post_ending_agent,
-)
+from core.agents.validate_blog_post_agent import create_validate_blog_post_agent
 
 __all__ = [
     "create_analyze_competitor_agent",
@@ -30,8 +29,9 @@
     "create_extract_links_agent",
     "create_find_competitors_agent",
     "create_generate_blog_post_content_agent",
+    "create_insert_internal_links_agent",
     "create_populate_competitor_details_agent",
     "create_summarize_page_agent",
     "create_title_suggestions_agent",
-    "create_validate_blog_post_ending_agent",
+    "create_validate_blog_post_agent",
 ]

core/agents/analyze_competitor_agent.py

@@ -1,8 +1,8 @@
 from django.utils import timezone
 from pydantic_ai import Agent, RunContext
 
+from core.agents.models import get_default_ai_model
 from core.agents.schemas import CompetitorAnalysis, CompetitorAnalysisContext
-from core.choices import get_default_ai_model
 
 
 def create_analyze_competitor_agent(model=None):
@@ -23,7 +23,7 @@ def create_analyze_competitor_agent(model=None):
             """
             You are an expert marketer.
             Based on the competitor details and homepage content provided,
-            extract and infer the requested information. Make reasonable inferences based
+            extract and infer the requested information. Make     reasonable inferences based
             on available content, context, and industry knowledge.
             """
         ),

core/agents/analyze_project_agent.py

@@ -1,8 +1,8 @@
 from pydantic_ai import Agent
 
+from core.agents.models import get_default_ai_model
 from core.agents.schemas import ProjectDetails, WebPageContent
 from core.agents.system_prompts import add_webpage_content
-from core.choices import get_default_ai_model
 
 
 def create_analyze_project_agent(model=None):
@@ -25,6 +25,7 @@ def create_analyze_project_agent(model=None):
             "on available content, context, and industry knowledge."
         ),
         retries=2,
+        model_settings={"temperature": 0.8, "thinking_budget": 0},
     )
     agent.system_prompt(add_webpage_content)
 

core/agents/competitor_vs_blog_post_agent.py

@@ -3,9 +3,9 @@
 from pydantic_ai.models.openai import OpenAIChatModel
 from pydantic_ai.providers.openai import OpenAIProvider
 
+from core.agents.models import AIModel
 from core.agents.schemas import CompetitorVsPostContext
 from core.agents.system_prompts import add_project_pages, markdown_lists
-from core.choices import AIModel
 
 
 def create_competitor_vs_blog_post_agent(model=None):
@@ -64,7 +64,7 @@ def create_competitor_vs_blog_post_agent(model=None):
     @agent.system_prompt
     def output_format() -> str:
         return """
-            IMPORTANT: Return only the text. Don't surround the text with ```markdown or ```.
+            Return only the text. Don't surround the text with ```markdown or ```.
         """
 
     @agent.system_prompt

core/agents/content_editor_agent.py

@@ -1,5 +1,6 @@
 from pydantic_ai import Agent
 
+from core.agents.models import get_default_ai_model
 from core.agents.schemas import BlogPostGenerationContext
 from core.agents.system_prompts import (
     add_language_specification,
@@ -8,7 +9,6 @@
     add_target_keywords,
     add_title_details,
 )
-from core.choices import get_default_ai_model
 
 
 def create_content_editor_agent(model=None):
@@ -31,13 +31,13 @@ def create_content_editor_agent(model=None):
         Your task is to edit the blog post content based on the requested changes.
         """,
         retries=2,
-        model_settings={"temperature": 0.3},
+        model_settings={"temperature": 0.3, "thinking_budget": 0},
     )
 
     @agent.system_prompt
     def only_return_the_edited_content() -> str:
         return """
-            IMPORTANT: Only return the edited content, no other text.
+            Only return the edited content, no other text.
         """
 
     agent.system_prompt(add_project_details)

core/agents/extract_competitors_data_agent.py

@@ -1,7 +1,7 @@
 from pydantic_ai import Agent, RunContext
 
+from core.agents.models import get_default_ai_model
 from core.agents.schemas import CompetitorDetails
-from core.choices import get_default_ai_model
 
 
 def create_extract_competitors_data_agent(model=None):
@@ -22,6 +22,7 @@ def create_extract_competitors_data_agent(model=None):
             Extract all the data from the text provided.
         """,
         retries=2,
+        model_settings={"temperature": 0.2, "thinking_budget": 0},
     )
 
     @agent.system_prompt

core/agents/extract_links_agent.py

@@ -1,6 +1,6 @@
 from pydantic_ai import Agent, RunContext
 
-from core.choices import get_default_ai_model
+from core.agents.models import get_default_ai_model
 
 
 def create_extract_links_agent(model=None):
@@ -24,6 +24,7 @@ def create_extract_links_agent(model=None):
             If the text contains no valid URLs, return an empty list.
         """,
         retries=2,
+        model_settings={"temperature": 0.2, "thinking_budget": 0},
     )
 
     @agent.system_prompt

core/agents/find_competitors_agent.py

@@ -3,8 +3,8 @@
 from pydantic_ai.models.openai import OpenAIChatModel
 from pydantic_ai.providers.openai import OpenAIProvider
 
+from core.agents.models import AIModel
 from core.agents.schemas import ProjectDetails
-from core.choices import AIModel
 
 
 def create_find_competitors_agent(is_on_free_plan: bool):
@@ -70,22 +70,14 @@ def number_of_competitors(ctx: RunContext[ProjectDetails]) -> str:
     @agent.system_prompt
     def language_specification(ctx: RunContext[ProjectDetails]) -> str:
         project = ctx.deps
-        return f"""
-            IMPORTANT: Be mindful that competitors are likely to speak in
-            {project.language} language.
-        """
+        return f"Be mindful that competitors are likely to speak in {project.language} language."  # noqa: E501
 
     @agent.system_prompt
     def location_specification(ctx: RunContext[ProjectDetails]) -> str:
         project = ctx.deps
         if project.location != "Global":
-            return f"""
-                IMPORTANT: Only return competitors whose target audience is in
-                {project.location}.
-            """
+            return f"Only return competitors whose target audience is in {project.location}."  # noqa: E501
         else:
-            return """
-                IMPORTANT: Return competitors from all over the world.
-            """
+            return "Return competitors from all over the world."
 
     return agent

core/agents/generate_blog_post_content_agent.py

@@ -1,19 +1,20 @@
 from pydantic_ai import Agent
 
+from core.agents.models import get_default_ai_model
 from core.agents.schemas import BlogPostGenerationContext, GeneratedBlogPostSchema
 from core.agents.system_prompts import (
     add_language_specification,
     add_project_details,
-    add_project_pages,
     add_target_keywords,
     add_title_details,
     add_todays_date,
+    add_validation_feedback,
     filler_content,
     markdown_lists,
     post_structure,
     valid_markdown_format,
 )
-from core.choices import ContentType, get_default_ai_model
+from core.choices import ContentType
 from core.prompts import GENERATE_CONTENT_SYSTEM_PROMPTS
 
 
@@ -23,6 +24,9 @@ def create_generate_blog_post_content_agent(
     """
     Create an agent to generate blog post content.
 
+    Note: This agent generates content WITHOUT internal links. Links will be inserted
+    in a separate step using the insert_internal_links_agent.
+
     Args:
         content_type: The type of content to generate (SHARING, ACTIONABLE, THOUGHT_LEADERSHIP).
         model: Optional AI model to use. Defaults to the default AI model.
@@ -36,15 +40,15 @@ def create_generate_blog_post_content_agent(
         deps_type=BlogPostGenerationContext,
         system_prompt=GENERATE_CONTENT_SYSTEM_PROMPTS[content_type],
         retries=2,
-        model_settings={"max_tokens": 65500, "temperature": 0.8},
+        model_settings={"max_tokens": 65500, "temperature": 0.3, "thinking_budget": 0},
     )
 
     agent.system_prompt(add_project_details)
-    agent.system_prompt(add_project_pages)
     agent.system_prompt(add_title_details)
     agent.system_prompt(add_todays_date)
     agent.system_prompt(add_language_specification)
     agent.system_prompt(add_target_keywords)
+    agent.system_prompt(add_validation_feedback)
     agent.system_prompt(valid_markdown_format)
     agent.system_prompt(markdown_lists)
     agent.system_prompt(post_structure)

core/agents/insert_internal_links_agent.py

@@ -0,0 +1,85 @@
+from pydantic_ai import Agent, RunContext
+
+from core.agents.models import get_default_ai_model
+from core.agents.schemas import InsertedLinksOutput, InsertInternalLinksContext
+
+
+def create_insert_internal_links_agent(model=None):
+    """
+    Create an agent to insert internal links into blog post content.
+
+    The agent takes existing blog post content and a list of internal pages,
+    then intelligently inserts links where they are contextually relevant.
+
+    Args:
+        model: Optional AI model to use. Defaults to the default AI model.
+
+    Returns:
+        Configured Agent instance
+    """
+    system_prompt = """
+You are an expert content editor specializing in internal linking strategies for SEO optimization.
+
+Your task is to take blog post content and intelligently insert internal links to relevant pages
+where they naturally fit and add value to the reader.
+
+## Guidelines for Link Insertion:
+
+1. **Natural Integration**: Insert links only where they enhance the reader's understanding or provide valuable additional context. Links should feel organic and not forced.
+
+2. **Contextual Relevance**: Match the page's topic with the surrounding content. Only link when there's a clear topical connection.
+
+3. **Anchor Text**: Use descriptive, natural anchor text that clearly indicates what the reader will find when clicking the link. Avoid generic phrases like "click here" or "this page".
+
+4. **Strategic Placement**:
+   - Prefer linking in the main body content rather than introductions or conclusions
+   - Space out links appropriately - avoid clustering multiple links in a single paragraph
+   - Link to each page at most once or twice in the entire article
+
+5. **Must-Use Pages**: These are high-priority pages that should be linked if there's any reasonable contextual fit. Be creative in finding natural places to mention and link to these pages.
+
+6. **Optional Pages**: Only link to these if they are highly relevant to the specific section of content where they would be inserted.
+
+7. **Markdown Format**: Use proper Markdown link syntax: `[anchor text](URL)`
+
+8. **Preserve Content**: Do not modify the existing content except to add links. Maintain all formatting, structure, and tone.
+
+9. **Quality Over Quantity**: It's better to have fewer, highly relevant links than many loosely related ones.
+
+## Output Requirements:
+Return the complete blog post content with internal links inserted. The content should be in Markdown format with proper link syntax.
+"""  # noqa: E501
+
+    agent = Agent(
+        model or get_default_ai_model(),
+        output_type=InsertedLinksOutput,
+        deps_type=InsertInternalLinksContext,
+        system_prompt=system_prompt,
+        retries=2,
+        model_settings={"max_tokens": 65500, "temperature": 0.3, "thinking_budget": 0},
+    )
+
+    @agent.system_prompt
+    def add_must_use_and_optional_pages(ctx: RunContext[InsertInternalLinksContext]) -> str:
+        return f"""
+        Must-use pages:
+        {ctx.deps.must_use_pages}
+        --------------------------------
+        Optional pages:
+        {ctx.deps.optional_pages}
+        """
+
+    @agent.system_prompt
+    def add_content(ctx: RunContext[InsertInternalLinksContext]) -> str:
+        return f"""
+        Content:
+        --------------------------------
+        {ctx.deps.content}
+        --------------------------------
+        """
+
+    @agent.system_prompt
+    def output() -> str:
+        return "Return only the post that I gave you, but with links."
+
+    return agent

core/agents/models.py

@@ -0,0 +1,14 @@
+from django.db import models
+
+
+class AIModel(models.TextChoices):
+    GEMINI_FLASH = "google-gla:gemini-2.5-flash", "Gemini 2.5 Flash"
+    PERPLEXITY_SONAR = "sonar", "Perplexity Sonar"
+
+
+DEFAULT_AI_MODEL = AIModel.GEMINI_FLASH
+
+
+def get_default_ai_model() -> str:
+    """Returns the default AI model to use across the application."""
+    return DEFAULT_AI_MODEL

core/agents/populate_competitor_details_agent.py

@@ -1,7 +1,7 @@
 from pydantic_ai import Agent, RunContext
 
+from core.agents.models import get_default_ai_model
 from core.agents.schemas import CompetitorDetails, WebPageContent
-from core.choices import get_default_ai_model
 
 
 def create_populate_competitor_details_agent(model=None):
@@ -27,6 +27,7 @@ def create_populate_competitor_details_agent(model=None):
             """
         ),
         retries=2,
+        model_settings={"temperature": 0.5, "thinking_budget": 0},
     )
 
     @agent.system_prompt