Skip to main content

Overview

Use Automations to run recurring AI Puffer tasks from WordPress. A task can create content, index WordPress content into a vector store, rewrite existing content, or reply to comments. In WordPress admin, go to AI Puffer > Automations. Set up the AI provider, image provider, vector store, or source connection required by the task you want to run. If the Automations menu is not visible, check that the module is enabled and that your WordPress role has access to it.

Create Content

Create posts from topics, CSV, RSS, URLs, and Sheets.

Optimize

Rewrite existing content and update products.

Content Indexing

Add WordPress content to vector stores on a schedule.

Comment Replies

Generate replies for approved WordPress comments.

Settings

Configure schedule, model, prompts, SEO, images, and knowledge.

Queue

Review pending, completed, and failed task items.

Connected Apps

Send automation events to external apps.

Logs

Review automation activity and generated output.

How Automations Run

Automations use .
  1. A task-specific cron event runs on the selected frequency.
  2. The task finds matching work and adds items to the queue.
  3. The main queue processor handles pending queue items in batches.
  4. Each queue item becomes Completed or Failed.
The queue processor handles up to 5 pending items per run. If more items remain, AI Puffer schedules another queue run about 30 seconds later.
WordPress cron depends on site traffic unless you run a real server cron. If site traffic is low, scheduled tasks can run late. If DISABLE_WP_CRON is enabled, set up a server cron job for WordPress.

Create Content

Create content tasks use the Content Writer engine inside Automations. They can create posts, pages, products, or other supported post types.

Manual Entry

Manual Entry reads each non-empty line as a content item. To create a Manual Entry automation:
  1. Click New Task.
  2. Select Manual Entry.
  3. Enter one topic per line.
  4. Add optional keywords, category ID, author, post type, or schedule date with the extended format.
  5. Set the model, prompts, publishing, image, and SEO options.
  6. Save the task.
Basic format:
Topic
Extended format:
Topic | Keywords | Category ID | Author Login | Post Type | YYYY-MM-DD HH:MM
Example:
How to clean leather boots | leather care, boots | 12 | editor | post | 2026-05-01 09:00
Manual Entry

CSV

CSV import reads every non-empty row. Download sample CSV To create a CSV automation:
  1. Click New Task.
  2. Select Import CSV.
  3. Upload the .csv file.
  4. Confirm that the rows were detected.
  5. Set the model, prompts, publishing, image, and SEO options.
  6. Save the task.
ColumnFieldRequired
1TopicYes
2KeywordsNo
3Category IDNo
4Author LoginNo
5Post TypeNo
6ScheduleNo
Do not include a header row unless you want the header row to be treated as a topic.
CSV

RSS Feed

RSS Feed creates posts from feed items. To create an RSS Feed automation:
  1. Click New Task.
  2. Select RSS Feed.
  3. Add one RSS feed URL per line.
  4. Add include keywords if only matching feed items should be used.
  5. Add exclude keywords if matching feed items should be skipped.
  6. Set the model, prompts, publishing, image, and SEO options.
  7. Set the task frequency.
  8. Save the task.
Scheduled RSS tasks use the task’s last run time and RSS history to avoid processing the same feed item again. Run Now checks recent feed items and still skips items that are already in the task history.
RSS

Web Page

Web Page creates posts from extracted URL content. To create a Web Page automation:
  1. Click New Task.
  2. Select Web Page.
  3. Add one URL per line.
  4. Set the model, prompts, publishing, image, and SEO options.
  5. Set the task frequency.
  6. Save the task.
AI Puffer extracts readable text from each URL and passes it to the content prompt. Useful placeholders:
PlaceholderValue
{url_content}Extracted page text.
{source_url}Source URL.
URL

Google Sheets

Google Sheets tasks create posts from spreadsheet rows. Open the sample Google Sheet, make a copy, and keep the same column order. AI Puffer reads columns A:G.
ColumnFieldNotes
ATopicRequired.
BKeywordsOptional.
CCategory IDOptional.
DAuthor LoginOptional.
EPost TypeOptional.
FSchedule DateOptional. Use YYYY-MM-DD HH:MM.
GStatusLeave empty for rows that should be processed.
Column G controls whether a row is processed. If column G has any value, AI Puffer skips that row.
Rows are processed only when column A has a topic and column G is empty. After a post is created, AI Puffer writes Processed on ... to column G so the row is not used again. If you use a header row, put a value in column G for that row, such as Status, so it is skipped.
Sheets
Before creating the task, set up Google access. AI Puffer uses a Google Cloud to read rows and write the processed status.
  1. Open Google Cloud Console.
  2. Create a new project, or select an existing project.
  3. Go to APIs & Services.
  4. Click Enable APIs and Services.
  5. Search for Google Sheets API.
  6. Select Google Sheets API and click Enable.
  7. Go to Credentials.
  8. Click Create credentials.
  9. Select Service account.
  10. Enter a service account name and click Done.
  11. Open the service account.
  12. Go to Keys.
  13. Click Add key.
  14. Select Create new key.
  15. Select JSON and click Create.
Create service account credentials
Create a service account key
Select JSON key type
Keep the service account JSON file private. Anyone with this file can use the permissions granted to that service account.
Google downloads a .json file. You will upload it in AI Puffer. Share the sheet with the service account:
  1. Open your Google Sheet.
  2. Click Share.
  3. Copy the service account email from Google Cloud or from the JSON file field named client_email.
  4. Share the sheet with that email as Editor.
Editor access is required because AI Puffer writes the processed status back to column G.
Copy the service account email
Share the sheet with the service account
Create the automation:
  1. Click New Task.
  2. Select Google Sheets as the task type.
  3. Paste the Google Sheet ID.
  4. Upload the service account JSON file.
  5. Wait for the connection check to pass.
  6. Set the model, prompts, publishing, image, and SEO options.
  7. Set the task frequency.
  8. Save the task.
The Google Sheet ID is the value between /d/ and /edit in the sheet URL.
https://docs.google.com/spreadsheets/d/GOOGLE_SHEET_ID/edit
Sheets

Optimize

Use Optimize tasks when you want scheduled updates for content that already exists in WordPress.
Automations Optimize task type

Rewrite Posts and Pages

Use Rewrite Content to update posts, pages, or custom post types on a schedule.
Rewrite Content updates WordPress content directly. Test with one small task before enabling a broad scheduled rewrite.
Rewrite Content automation
Choose which content the task can update.
FilterNotes
Post TypesRequired. Select one or more post types.
CategoriesOptional. Applies to category-supported content.
AuthorsOptional. Limits updates to selected authors.
StatusesPublished, Draft, or Pending Review.
Use Queue all matching content now to enqueue the matching content one time when the task is saved. If this option is off, scheduled runs process content that becomes eligible later. Select at least one field to update. Each selected field has its own prompt.
FieldWhat AI Puffer updates
TitleWordPress post title.
ExcerptWordPress post excerpt.
ContentWordPress post content.
Meta DescriptionSEO meta description in supported SEO plugins.
Use placeholders in rewrite prompts to include existing post data.
PlaceholderValue
{original_title}Existing post title.
{original_content}Existing post content without shortcodes and HTML.
{original_excerpt}Existing excerpt.
{original_meta_description}Existing meta description or excerpt fallback.
{original_focus_keyword}Existing focus keyword when available.
{original_tags}Existing tags.
{categories}Existing categories.
Rewrite Content can optionally use vector context from the right-side Advanced card.
ProviderRequired setup
OpenAISelect OpenAI Vector Stores.
PineconeSelect a Pinecone index and embedding model.
QdrantSelect a Qdrant collection and embedding model.
The task searches the selected knowledge source using the post title and adds matching context to the AI request.
For Pinecone and Qdrant, use the same that was used when the data was added.
To create a Rewrite Content automation:
  1. Click New Task.
  2. Select Rewrite Content.
  3. Select the post types to update.
  4. Add category, author, or status filters if needed.
  5. Choose whether to queue all matching content now.
  6. Select the fields AI Puffer should update.
  7. Review the prompt for each selected field.
  8. In Advanced, set Context if the rewrite should use stored knowledge.
  9. Set the task frequency.
  10. Save the task.
When the task runs, AI Puffer finds matching content, queues it, and updates only the fields you selected. Run Now queues matching content that is not already present in that task’s queue history.

WooCommerce Products

Use Rewrite Content with the product post type to update WooCommerce product copy on a schedule.
WooCommerce product rewrite automation
The task can update these product fields:
FieldWhat AI Puffer updates
TitleProduct name.
ExcerptProduct excerpt or short description.
ContentMain product description.
Meta DescriptionSEO meta description in supported SEO plugins.
Price, SKU, stock, dimensions, purchase note, categories, and attributes can be used in prompts as source data. AI Puffer does not change those WooCommerce product fields in this task. Product prompts can use the normal post placeholders and these WooCommerce placeholders:
PlaceholderValue
{price}Product price.
{regular_price}Product regular price.
{sku}Product SKU.
{attributes}Product attributes.
{stock_quantity}Stock quantity.
{stock_status}Stock status.
{weight}Product weight.
{length}Product length.
{width}Product width.
{height}Product height.
{purchase_note}Product purchase note.
{product_categories}Product categories.
To create a WooCommerce product update automation:
  1. Click New Task.
  2. Select Rewrite Content.
  3. Select product under Post Types.
  4. Add category, author, or status filters if needed.
  5. Choose whether to queue matching products now.
  6. Select the product fields AI Puffer should update.
  7. Review the prompt for each selected field.
  8. In Advanced, set Context if product copy should use stored product or business information.
  9. Set the task frequency.
  10. Save the task.

Content Indexing

Use Content Indexing to add WordPress content to a vector store for later retrieval.
Content Indexing automation
DestinationRequired setup
OpenAISelect an OpenAI Vector Store.
PineconeSelect a Pinecone index and embedding provider/model.
QdrantSelect a Qdrant collection and embedding provider/model.
Pinecone and Qdrant require an because AI Puffer needs to create embeddings before writing vectors.
For Pinecone and Qdrant, the index or collection dimension must match the embedding model.
Content selection settings:
SettingWhat it does
Post TypesSelects the public post types to index.
Queue existing content nowQueues matching published content for initial indexing.
Auto-index new and updated contentKeeps the vector store updated when selected content changes.
FrequencyControls how often the task checks for work.
Content Indexing only queues published content.
To create a Content Indexing automation:
  1. Click New Task.
  2. Select Content Indexing.
  3. Choose OpenAI, Pinecone, or Qdrant as the destination.
  4. Select the vector store, index, or collection.
  5. For Pinecone or Qdrant, select the embedding provider and model.
  6. Select the public post types to index.
  7. Choose whether to queue existing content now.
  8. Choose whether new and updated content should be indexed automatically.
  9. Set the task frequency.
  10. Save the task.
Queue all existing content now creates an initial batch for matching published content. AI Puffer queues existing content in batches of 200 posts. After the initial queueing pass finishes, the one-time flag is turned off for the task. Run Now queues all matching published content again. Auto-index new and updated content checks posts modified after the task’s last run time. Use this when the vector store should stay in sync with published WordPress content.

Comment Replies

Use Comment Replies to draft and publish replies to WordPress comments.
Comment Replies automation
SettingWhat it does
Post TypesSelects which comment areas the task monitors.
Approve ImmediatelyInserts the AI reply as an approved comment.
Hold for ModerationInserts the AI reply as an unapproved comment.
Do not reply to other repliesLimits the task to top-level comments.
Include keywordsReplies only when the comment contains at least one keyword.
Exclude keywordsSkips comments that contain any excluded keyword.
Use placeholders to include the original comment and post title in the reply prompt.
PlaceholderValue
{comment_content}Original comment text.
{comment_author}Original comment author.
{post_title}Title of the commented post.
To create a Comment Replies automation:
  1. Click New Task.
  2. Select Comment Replies.
  3. Select the post types to monitor.
  4. Choose whether to reply only to top-level comments.
  5. Choose whether replies should be approved immediately or held for moderation.
  6. Add include or exclude keywords if needed.
  7. Review the reply prompt.
  8. Select the model.
  9. Set the task frequency.
  10. Save the task.
Scheduled runs check approved comments. Each run queues up to 50 matching comments. AI Puffer checks whether a comment is already queued or already has a reply from the same task before adding it again. Replies are inserted as child comments. The reply author is the post author when possible, with a fallback to the site administrator.

Settings

Automation settings appear in the right-side cards after you choose a task type.

Task Schedule

Task schedule controls whether the task is active and when AI Puffer checks for work. These settings are in the right-side Schedule card.
SettingWhat it does
ActiveSchedules the task.
PausedStops future scheduled runs. Existing queue items remain in the queue.
FrequencyControls how often AI Puffer checks the task source.
Frequency
Available frequencies:
FrequencyNotes
One-timeRuns once.
Every 5 MinutesUses a custom WordPress cron interval.
Every 15 MinutesUses a custom WordPress cron interval.
Every 30 MinutesUses a custom WordPress cron interval.
HourlyUses the WordPress hourly interval.
Twice DailyUses the WordPress twice-daily interval.
DailyUses the WordPress daily interval.
WeeklyUses a custom WordPress cron interval.
Manual Entry and CSV tasks are one-time tasks. RSS Feed, Web Page, Google Sheets, Rewrite Content, Content Indexing, and Comment Replies can use recurring frequencies. The first run is scheduled shortly after the task is saved or resumed.

AI

AI settings choose the model that writes the content. To set the model:
  1. In the right-side General card, use Model to choose the provider and model.
  2. Select Length for content creation tasks.
  3. Click the settings icon next to Model to open Model settings.
  4. Adjust Temperature if you want more or less variation.
  5. Set Reasoning only for models that support it. Keep it on None for faster runs.
SettingWhat it does
ModelProvider and model used by the task.
LengthToken budget for generated content.
TemperatureResponse variation.
ReasoningReasoning effort for supported OpenAI and Ollama models.
Model
Length values map to these token budgets:
LengthToken budget
Short2000
Medium4000
Long6000
Model Settings
If the provider or model list is empty, configure the provider first in AI Providers.

Prompts

Prompts are the instructions Automations sends to the selected model. Content creation tasks can generate a title, content, SEO fields, excerpt, tags, inline image prompt, and featured image prompt. To customize prompts:
  1. In the right-side General card, click Customize next to Prompts.
  2. Enable the outputs you want AI Puffer to generate.
  3. Click the edit icon next to an output.
  4. Select a saved prompt or edit the prompt text directly.
  5. Use the variables shown under the editor.
  6. Save the task and run one test item before enabling a larger task.
OutputWhat it creates
TitleWordPress post title.
ContentWordPress post content.
Meta DescriptionSEO meta description.
Focus KeywordFocus keyword in supported SEO plugins.
ExcerptWordPress excerpt.
TagsWordPress tags or product tags.
Content ImagePrompt used for inline images.
Featured ImagePrompt used for the post thumbnail.
Available variables change by source.
SourceVariables to use
Manual Entry, CSV, Google SheetsUse {topic} and {keywords}.
RSS FeedUse {description} and {source_url}.
Web PageUse {url_content} and {source_url}.
SEO, excerpt, tagsUse {content_summary} when the output should be based on the generated article.
Prompts
AI Puffer checks required variables before generation. If a required variable is missing, the task will not run until the prompt is fixed.

SEO

Use SEO settings when generated posts should include search metadata. AI Puffer can create a meta description, focus keyword, tags, and a cleaner WordPress URL slug. To generate SEO output:
  1. In the right-side General card, click Customize next to Prompts.
  2. Enable Meta Description, Focus Keyword, or Tags.
  3. Edit the enabled prompts if needed.
  4. In the right-side Schedule card, click the settings icon next to Status to open Post settings.
  5. Enable Optimize URL if AI Puffer should update the post slug.
  6. Save and test the task.
OutputHow it is saved
Meta DescriptionSaved to the active SEO plugin. If no supported SEO plugin is active, AI Puffer saves fallback post meta.
Focus KeywordSaved to Yoast SEO, Rank Math, or All in One SEO.
TagsSaved as WordPress tags or product tags.
URLUpdates the WordPress post slug when Optimize URL is enabled.
SEO

Yoast SEO

AI Puffer saves the generated meta description to the Yoast meta description field and the generated focus keyword to the Yoast focus keyphrase field. If Optimize URL is enabled, the slug is built from the focus keyphrase when available. If there is no focus keyphrase, the post title is used.

Rank Math

AI Puffer saves the generated meta description to the Rank Math description field and the generated focus keyword to the Rank Math focus keyword field.

All in One SEO

AI Puffer saves the generated meta description to All in One SEO and updates the focus keyphrase data used by AIOSEO.

The SEO Framework

AI Puffer saves the generated meta description to The SEO Framework description field. The SEO Framework does not provide a native focus keyword field, so AI Puffer does not save a focus keyword for it. If none of the supported SEO plugins are active, AI Puffer still saves the meta description as fallback post meta. WordPress tags and the optimized URL slug still work without an SEO plugin.

Publishing

Publishing settings control the WordPress post created by a content creation task. To set the post target:
  1. In the right-side Schedule card, select the post Status.
  2. Click the settings icon next to Status to open Post settings.
  3. Select the Post Type.
  4. Select the Author.
  5. Select categories if the post type supports categories.
  6. Enable Table of Contents if needed.
  7. Enable Optimize URL if AI Puffer should generate a cleaner slug.
SettingWhat it does
StatusDraft, Publish, Pending Review, or Private.
Post TypePublic WordPress post type.
AuthorWordPress author.
CategoriesCategories assigned to the post when supported by the post type.
Table of ContentsAdds a generated table of contents to the top of the post.
Optimize URLUpdates the WordPress slug after the post is saved.
publishing

Schedule

Content creation tasks have a task schedule and a post publishing schedule. The task schedule controls when AI Puffer checks the source and queues work. The post publishing schedule controls the date used for the generated WordPress post.
Publishing modeWhat it does
Publish ImmediatelyCreates the post with the selected post status.
Smart ScheduleSchedules generated posts starting from a selected date and spaced by hours or days.
Use Dates from InputReads the date from Batch Editor, Quick Paste, CSV, or Google Sheets.
schedule
Supported input date examples:
2026-05-01 09:00
2026-05-01 09:00:30
2026/05/01 09:00
05/01/2026 09:00
01/05/2026 09:00
2026-05-01T09:00:00Z
2026-05-01T09:00:00+02:00
Dates without a timezone are interpreted using the WordPress site timezone.

Images

Image settings can add images inside generated content, set a featured image, or both. To enable images:
  1. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  2. Select the image provider or model from Image source.
  3. Click the settings icon beside Image source to open Image settings.
  4. Set count, placement, size, and alignment for content images.
  5. To change image prompts, in the right-side General card, click Customize next to Prompts and edit Content Image or Featured Image.
ModeResult
OffNo images are generated or fetched.
ContentAdds images inside the post content.
FeaturedSets a featured image.
Content + FeaturedAdds content images and sets a featured image.
images
Supported image sources:
SourceSetup
OpenAIAdd the OpenAI API key in AI Puffer > Settings > AI and sync image models.
GoogleAdd the Google API key in AI Puffer > Settings > AI and sync image models.
OpenRouterAdd the OpenRouter API key in AI Puffer > Settings > AI and sync image-capable models.
AzureAdd the Azure endpoint, API key, API version, and image deployment in AI Puffer > Settings > AI.
ReplicateAdd the Replicate API key in AI Puffer > Settings > Integrations and sync models.
PexelsAdd the Pexels API key in AI Puffer > Settings > Integrations.
PixabayAdd the Pixabay API key in AI Puffer > Settings > Integrations.
For content images, placement controls where images appear after the post is saved.
PlacementResult
After 1st H2Inserts the first image after the first H2 heading.
After 1st H3Inserts the first image after the first H3 heading.
Every X H2sInserts images after every selected number of H2 headings.
Every X H3sInserts images after every selected number of H3 headings.
Every X paragraphsInserts images after every selected number of paragraphs.
End of contentAdds images at the end of the article.
images
Pexels can filter by orientation, size, and color. Pixabay can filter by orientation, type, and category.

OpenAI

OpenAI uses your OpenAI API key and one of the image models available in your synced model list. To set it up:
  1. Go to AI Puffer > Settings > AI.
  2. Select OpenAI.
  3. Add your OpenAI API key.
  4. Sync models.
  5. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  6. Select an OpenAI image model from Image source.

Google

Google uses your Google API key and the Google image models available in your synced model list. To set it up:
  1. Go to AI Puffer > Settings > AI.
  2. Select Google.
  3. Add your Google API key.
  4. Sync models.
  5. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  6. Select a Google image model from Image source.

OpenRouter

OpenRouter uses image-capable models from your OpenRouter account. To set it up:
  1. Go to AI Puffer > Settings > AI.
  2. Select OpenRouter.
  3. Add your OpenRouter API key.
  4. Sync models.
  5. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  6. Select an OpenRouter image model from Image source.
If a selected OpenRouter model does not return images, choose another image-capable model from the synced list.

Azure

Azure uses your Azure OpenAI endpoint, API key, API version, and image deployment. To set it up:
  1. Go to AI Puffer > Settings > AI.
  2. Select Azure.
  3. Add the Azure endpoint and API key.
  4. Add or sync the image deployment you want to use.
  5. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  6. Select the Azure image deployment from Image source.

Replicate

Replicate uses your Replicate API key and synced text-to-image models. To set it up:
  1. Go to AI Puffer > Settings > Integrations.
  2. Select Replicate.
  3. Add your Replicate API key.
  4. Sync Replicate models.
  5. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  6. Select a Replicate model from Image source.

Pexels

Pexels searches stock photos instead of generating a new image. To set it up:
  1. Go to AI Puffer > Settings > Integrations.
  2. Select Pexels.
  3. Add your Pexels API key, or use the Get Key link to create one.
  4. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  5. Select Pexels from Image source.
  6. Click the settings icon beside Image source to open Image settings.
  7. Set Orientation, Size, and Color if you want to filter results.

Pixabay

Pixabay searches stock photos, illustrations, or vectors. To set it up:
  1. Go to AI Puffer > Settings > Integrations.
  2. Select Pixabay.
  3. Add your Pixabay API key, or use the Get Key link to create one.
  4. In the right-side Media card, set Images to Content, Featured, or Content + Featured.
  5. Select Pixabay from Image source.
  6. Click the settings icon beside Image source to open Image settings.
  7. Set Orientation, Type, and Category if you want to narrow results.

Image Prompts

For AI image providers, the image prompt controls content images and the featured image prompt controls the featured image. To edit them, in the right-side General card, click Customize next to Prompts and open Content Image or Featured Image. You can use these placeholders:
PlaceholderReplaced with
{topic}Generated title.
{keywords}Generated keywords.
{post_title}WordPress post title.
{excerpt}Generated excerpt.
images

Knowledge Base

Knowledge Base lets content creation and Rewrite Content tasks use vector data from AI Puffer > Knowledge Base. When enabled, AI Puffer searches the selected source and adds matching context to the generation request. To enable it:
  1. Add data in AI Puffer > Knowledge Base.
  2. In the right-side Advanced card, set Context to OpenAI, Pinecone, or Qdrant.
  3. Select the vector store, index, or collection in Source.
  4. Click the settings icon beside Source to open Context settings.
  5. Set Results Limit. For content creation tasks, you can also set Confidence Threshold.
  6. For Pinecone or Qdrant, select the embedding provider and model in Context settings.
  7. Save and test the task.
Vector
ProviderRequired setup
OpenAISelect one or more OpenAI Vector Stores.
PineconeSelect a Pinecone index and the embedding model used when the data was added.
QdrantSelect a Qdrant collection and the embedding model used when the data was added.
For Pinecone and Qdrant, use the same embedding model when adding data and when selecting Context in an automation task.

OpenAI

OpenAI uses OpenAI Vector Stores. To prepare a vector store:
  1. Go to AI Puffer > Knowledge Base.
  2. Select OpenAI as the provider.
  3. Click Create new vector store.
OpenAI Create Vector
  1. Enter a store name and create it.
  2. Add data to the store.
OpenAI Add Data
To use it in Automations:
  1. Add data to an OpenAI Vector Store in AI Puffer > Knowledge Base.
  2. Create or edit the automation task.
  3. In the right-side Advanced card, set Context to OpenAI.
  4. Select one or more vector stores in Source.
  5. Click the settings icon beside Source to adjust Results Limit. Content creation tasks also show Confidence Threshold.

Pinecone

Pinecone stores vectors in an index. AI Puffer creates and searches those vectors with the embedding model you choose. The Pinecone index dimension must match the embedding model. For example, if your index is 3072 dimensions, use a 3072-dimension embedding model. To prepare an index:
  1. Add your Pinecone credentials in AI Puffer > Settings > Integrations.
Pinecone API key
  1. Go to AI Puffer > Knowledge Base.
  2. Select Pinecone as the provider.
  3. Select the embedding model you want to use.
  4. Click Create new index.
Pinecone Create Index
  1. Enter an index name and use the dimension for the selected embedding model.
  2. Create the index, then add data with the same embedding model.
Pinecone Create Index
To use it in Automations:
  1. Create or edit the automation task.
  2. In the right-side Advanced card, set Context to Pinecone.
  3. Select the Pinecone index in Source.
  4. Click the settings icon beside Source to open Context settings.
  5. Select the same embedding provider and model used when you added the data.
  6. Adjust Results Limit. Content creation tasks also show Confidence Threshold.

Qdrant

Qdrant stores vectors in a collection. AI Puffer creates and searches those vectors with the embedding model you choose. The Qdrant collection size must match the embedding model. For example, if your collection is 3072 dimensions, use a 3072-dimension embedding model. To prepare a collection:
  1. Add your Qdrant URL and API key in AI Puffer > Settings > Integrations.
Qdrant API key
  1. Go to AI Puffer > Knowledge Base.
  2. Select Qdrant as the provider.
  3. Select the embedding model you want to use.
  4. Click Create new collection.
Qdrant Create collection
  1. Enter a collection name and use the dimension for the selected embedding model.
  2. Create the collection, then add data with the same embedding model.
Qdrant Create collection
To use it in Automations:
  1. Create or edit the automation task.
  2. In the right-side Advanced card, set Context to Qdrant.
  3. Select the Qdrant collection in Source.
  4. Click the settings icon beside Source to open Context settings.
  5. Select the same embedding provider and model used when you added the data.
  6. Adjust Results Limit. Content creation tasks also show Confidence Threshold.

Limit and Threshold

Use these settings to control how much vector context is added to the task.
SettingHow it works
Results LimitMaximum number of matching knowledge pieces AI Puffer can use.
Confidence ThresholdHow closely a result must match before AI Puffer includes it.
Vector

Queue

The queue shows work created by saved tasks and Run Now actions.
queue
StatusMeaning
PendingWaiting to be processed.
ProcessingCurrently being handled by the queue processor.
CompletedFinished successfully.
FailedThe queue item returned an error.
Queue controls:
ControlWhat it does
SearchSearches target identifiers and task names.
Status filterShows all items or one status.
RetryMoves a failed item back to pending and starts queue processing.
DeleteDeletes one queue item.
Delete filteredDeletes queue items matching the current filter.
Completed content creation items can show the generated post when a post ID is available.

Connected Apps

Automations can send task results to Connected Apps and webhooks.
EventWhen it fires
content.generatedAfter a content creation task creates a post.
task.item_completedAfter a queue item finishes successfully.
Use these events when another system needs the generated post, task result, or queue item details. Recipe templates include generated content or completed task notifications for apps such as Slack, Notion, Zapier, and Make.

Logs

Automation activity can appear in AI Puffer logs.
Task areaLog module
Content creationcontent_writer_automation
Comment repliescommunity_reply_comments
Queue status and error messages remain visible in the Automations queue.

Troubleshooting

Check these items:
  1. Confirm the task status is Active.
  2. Check the next run time in the task list.
  3. Confirm WordPress cron is working.
  4. If DISABLE_WP_CRON is enabled, configure a server cron job.
  5. Check whether the task already has pending or processing queue items.
Content creation tasks do not queue another scheduled batch while that same task already has pending or processing items.
Possible causes:
Task typeCheck
Manual EntryThe input must contain at least one non-empty topic line.
CSVThe CSV must contain topic rows.
RSS FeedThe feed must contain new unprocessed items that pass the filters.
Web PageThe URLs must be reachable and extractable.
Google SheetsColumn A must contain a topic and column G must be empty.
Rewrite ContentThe selected post type, status, author, and category filters must match content.
Content IndexingMatching content must be published.
Comment RepliesMatching comments must be approved.
  1. Open the queue.
  2. Read the error message.
  3. Fix the provider, model, source, prompt, or destination setting.
  4. Click Retry.
Check these items:
  1. The Sheet ID is correct.
  2. The service account JSON credentials are valid.
  3. The spreadsheet is shared with the service account email.
  4. Column A has a topic.
  5. Column G is empty.
Check these items:
  1. The selected vector store, index, or collection exists.
  2. Pinecone and Qdrant have an embedding provider and model selected.
  3. The selected post types contain published content.
  4. The provider API key is configured in AI Providers.
Check these items:
  1. The comment is approved.
  2. The comment belongs to a selected post type.
  3. The include and exclude keyword filters allow the comment.
  4. The reply prompt is not empty.
  5. The selected model is configured.