> ## Documentation Index > Fetch the complete documentation index at: https://docs.trysight.ai/llms.txt > Use this file to discover all available pages before exploring further. # Article Agent > Your AI content marketing team — customize each writing-pipeline sub-agent to craft articles exactly the way you want. ## Your Content Marketing Team Sight AI gives you a full AI content marketing team. Instead of a single AI writing your articles, **8 specialized agents** each handle a different part of the process — just like a real content team with dedicated roles. You can customize each agent's behavior with specific instructions, giving you fine-grained control over every aspect of your content. The Article Agent page lives at `app.trysight.ai/agents/writing` (formerly `/ai-agents` and `/content/ai-agents` — the old URLs still redirect). > **Heads up:** The Article Agent is composed of 8 *sub-agent roles inside the article-generation pipeline* (Research, Writer, SEO, etc.). It's different from the newer [Automations](/automations/overview), which are *autonomous workers that drive the pipeline for you* (e.g., the Search Opportunity Agent reads your opportunity queue and hands articles off to the Article Agent to write). ## Meet Your Agents ### Research Specialist **What they do:** Gathers information, analyzes competitors, and identifies key points to cover in your article. * Searches for relevant data, statistics, and sources * Analyzes top-ranking competitor content for the target keyword * Identifies content gaps and unique angles * Compiles research into a structured brief for the writing team **When to customize:** When you want research to focus on specific sources, industries, competitors, or data types. For example, instruct the Research Specialist to prioritize academic sources or focus on a specific geographic market. ### Content Strategist **What they do:** Creates the article outline and determines the best structure and flow. * Designs the article's heading structure and hierarchy * Plans the content flow from introduction to conclusion * Determines which subtopics to include and in what order * Ensures the outline targets the focus keyword effectively **When to customize:** When you have a preferred article structure, want to emphasize certain subtopics, or need the outline to follow a specific template. ### Content Writer **What they do:** Writes the full article based on the research brief and strategic outline. * Drafts all sections of the article in your brand voice * Incorporates research data, examples, and supporting evidence * Follows the outline structure while maintaining natural flow * Adapts tone and complexity to your target audience **When to customize:** When you want to adjust writing style, tone, reading level, sentence structure, or the use of specific terminology. This is the most commonly customized agent. ### Quality Editor **What they do:** Reviews the draft for clarity, grammar, readability, and overall quality. * Checks for grammatical errors and awkward phrasing * Improves sentence structure and paragraph flow * Ensures consistency in tone and style throughout the article * Verifies factual accuracy and logical coherence **When to customize:** When you have specific editorial standards, style guide requirements, or quality thresholds you want enforced. ### SEO Optimizer **What they do:** Refines the article for search engine performance. * Optimizes meta title and meta description * Improves keyword placement and density * Enhances heading tags for SEO value * Adds schema markup and structured data * Ensures readability scores meet SEO best practices **When to customize:** When you have specific SEO guidelines, keyword density targets, or want to prioritize certain ranking factors. ### Headline Specialist **What they do:** Crafts compelling headlines and subheadings that drive clicks and engagement. * Writes the primary article headline (H1) * Refines subheadings for clarity and engagement * Optimizes headlines for both search engines and readers * A/B tests headline variations for effectiveness **When to customize:** When you have a preferred headline style, want to include specific power words, or need headlines to follow a particular formula. ### Visual Designer **What they do:** Generates and selects images to enhance the article. * Creates AI-generated images relevant to the article's content * Writes descriptive alt text for accessibility and SEO * Determines optimal image placement within the article * Ensures visual consistency across your content **When to customize:** When you want a specific image style, prefer certain types of visuals (illustrations vs. photography), or have brand guidelines for imagery. ### Link Strategist **What they do:** Adds internal and external links to strengthen the article's SEO and reader experience. * Identifies opportunities for internal links to your existing content * Finds authoritative external sources to cite * Ensures link anchor text is natural and relevant * Balances link density for readability and SEO **When to customize:** When you want to prioritize linking to specific pages, avoid certain external domains, or control how many links appear in each article. ## How to Customize Agents 1. Navigate to **AI Agents** → **Article Agent** in the sidebar (or go directly to `/agents/writing`) 2. Select the agent you want to customize 3. Enter your custom instructions in the text field 4. Click **Save** Your instructions are applied to every article generated for that site. You can update them at any time — changes apply to future articles only. ## Example Instructions ### For the Content Writer ``` Write in a conversational, friendly tone. Use short paragraphs (2-3 sentences max). Avoid jargon and explain technical terms when first introduced. Include real-world examples and analogies to make complex topics accessible. Address the reader directly using "you" and "your." ``` ### For the Research Specialist ``` Focus on data from the last 12 months. Prioritize statistics from industry reports, peer-reviewed studies, and official documentation. Always include at least 3 data points or statistics per article. Avoid referencing competitor products by name unless doing a comparison piece. ``` ### For the Headline Specialist ``` Use numbers in headlines when possible (e.g., "7 Ways to..."). Keep headlines under 60 characters for SEO. Avoid clickbait -- headlines should accurately reflect the content. Include the focus keyword naturally within the first 3 words when possible. ``` ## Team vs. Agent Instructions Sight AI supports two levels of instructions: * **Team instructions** -- Applied globally to all agents. Use these for overarching guidelines like brand voice, target audience, and general content rules. * **Agent instructions** -- Applied to a specific agent only. Use these for role-specific guidance that only affects one part of the pipeline. Agent instructions take priority when they conflict with team instructions for that agent's specific task. ## Business Info and CTA In addition to agent instructions, you can configure: * **Business information** -- Your company name, industry, product/service descriptions, and target audience. This context is shared with all agents to ensure content is relevant and on-brand. * **Call to action (CTA)** -- A default CTA that agents include in articles. Set the CTA text, URL, and placement preferences. ## Troubleshooting ### Tone doesn't match expectations Add more specific instructions to the **Content Writer** agent. Include examples of the tone you want, such as: "Write like a knowledgeable friend explaining something over coffee -- casual but credible." ### Article structure isn't right Customize the **Content Strategist** agent with your preferred outline format. You can provide a template structure that the agent should follow. ### Content lacks depth Instruct the **Research Specialist** to gather more data points and the **Content Writer** to include more examples, case studies, and supporting evidence. ### Headings are too generic Give the **Headline Specialist** examples of headings you like and specific guidelines for the style you prefer. ### SEO score is low Add specific SEO requirements to the **SEO Optimizer** agent, such as target keyword density, meta description length, or heading tag rules. ### Content doesn't reflect your brand Add detailed business context in the **Business Info** section and provide brand voice guidelines in the **Team Instructions**. ### Too many or too few links Adjust the **Link Strategist** instructions with specific rules, such as "Include 3-5 internal links and 2-3 external links per article." ### Images don't match your brand Customize the **Visual Designer** with your preferred image style, color palette, or visual themes. ## Best Practices * **Start with team instructions** to set the overall tone and guidelines, then customize individual agents as needed * **Be specific** -- vague instructions produce vague results. Instead of "write well," say "use short sentences, active voice, and include one example per section" * **Test and iterate** -- generate a test article, review the output, and refine your instructions based on what you see * **Don't over-constrain** -- too many conflicting instructions can confuse agents. Focus on the most important guidelines * **Review periodically** -- update your instructions as your brand voice, audience, or content strategy evolves