Skip to main content

Creating an AgenticCatalog Feed Source

šŸ“˜ This article explains how to create a feed source in AgenticCatalog, which defines how Botify pushes your product feeds to AI systems. AgenticCatalog is part of Botify's Activation Suite, available as an option with all Botify plans.

Overview

An AgenticCatalog feed source stores all the details for AgenticCatalog feeds. Get started with AgenticCatalog by creating a feed source to identify:

After creating the feed source with at least one configured destination, the enrichment process begins. You can optionally test the AgenticCatalog enrichment before pushing any feeds to a destination.

Identifying the feed source details

  1. Click Create source.

  2. Provide a name to identify the feed on the AgenticCatalog landing page.

  3. Optionally provide a description, currency for your product prices, and the language for generated content.

  4. Specify where your product feed source is located, filling at least the required fields (labeled with an asterisk):

    • GCS: Google Cloud Storage.

    • S3: Amazon Web Services Simple Storage Service.

    • URL: The full URL where the source is located, including the protocol.

  5. If the source location is not publicly accessible, deselect the ā€œThe bucket is publicly accessibleā€ option, then add the credentials.

  6. Click Create source. The source feed is now associated with this source configuration, and you can configure where to push the enriched feeds.

šŸ”’ About scheduling

The screenshot above shows an Admin-only feature that sets the schedule when AgenticCatalog will pull the source feed from the identified location. The schedule is typically set in your Botify contract, but contact your Account Manager if you need to request a schedule change.

Schedule details

AgenticCatalog can pull a source feed up to four times/day. The schedule format uses five fields, read left to right:

  • Minute (0-59)

  • Hour (0-23)

  • Day of month (1-31)

  • Month (1-12)

  • Day of week (0-6, where 0 is Sunday)

which can be modified by the following characters:

Character

Function

Example

*

"every"

* in the Month field is every month).

,

list of values

1,15 in the Day of Month field is the 1st and 15th.

-

range of values

1-5 in the Day of Week field is Monday through Friday.

*/

step intervals

*/10 in the Minute field means every 10 minutes.

šŸ‘€ The example in the screenshot above shows every six hours, every day.

šŸ’” You can upload a sample feed to test the AgenticCatalog enrichment before configuring the feed source destinations. To do this, click Save changes at the bottom. You can then access the ā€œSample Feedā€ section.

Configuring feed source destinations

Destinations are where you want AgenticCatalog to push your product feed.

To enable a destination:

  1. Click Configure next to the destination name.

  2. Enter the destination-specific connection details.

  3. Set the attribute rules, then click Save changes. The destination is now enabled for the feed source. You can disable a destination at any time and maintain its settings.

šŸ”’ Like the fetch schedule, Botify sets the push schedule according to your contract terms.

Identifying attribute rules

The attributes associated with each destination automatically populate the Attribute rules section of the destination settings.

šŸ’” Use the search field at the top of the section to find specific attributes.

To customize the attribute rules:

  1. Deselect the ā€œInclude in destinationā€ checkbox next to attributes you do not want to push to the destination.

  2. Select an option in the Enrich column to determine when to apply attribute enrichments:

    • Always enrich: Attribute enrichment is applied to the feed regardless of whether the attribute has a value in the source feed.

    • Enrich when empty: The attribute enrichment is applied to the feed only when the attribute has no value in the ingested feed.

    • Never enrich: The attribute enrichment is never applied to the feed, even when the attribute does not have a value in the ingested feed.

    • Static value: Set a string as the attribute value for every product. Identify the value in the text box that appears below this option when you select it. This option is only available for some OpenAI attributes.

  3. Click Save changes.

šŸ‘‰ You cannot modify a destination’s required attributes.

You can customize the attribute rules further by identifying:

Identifying query parameters

To enable tracking and attribution, you can identify link parameters to add to every product URL.

To add query parameters:

  1. When identifying a destination’s attribute rules, click the icon at the end of the URL attribute row.

  2. Add a key and value pair to be appended to URLs. Use the preview bar to confirm the query parameter looks as intended.

  3. Repeat to add more parameters, then click Done. The query parameter will be added to all URLs in this destination’s feed.

Identifying row filters (OpenAI only)

Row filters let you define conditions that will eliminate attributes from feeds pushed to OpenAI.

To add a row filter:

  1. Select a filter from the dropdown, then click Add.

  2. Repeat for all filters, then click Save changes.

The following filters are available:

  • final_sale: Exclude products that do not have an empty or null value in the final_sale attribute.

  • shipping: Exclude products when the shipping value has no content (e.g., :::).

  • quantity: Exclude products with a known quantity below the defined threshold.
    ​

šŸ‘€ Row filters that are not yet applied to the feed are labeled with ā€œNot in productionā€. Saving the feed source version to enable these filters in production.

About feed ingestion

After you create your AgenticCatalog feed source, Botify ingests your feed according to your settings and schedule. When ingestion is complete, you can view the feed via the Preview button in the feed source settings:
​

Configuring enrichment options

After defining your feed source and destinations, the Enrichment configuration options display. The enrichment configuration lets you optionally customize AgenticCatalog’s feed enrichment.

To configure enrichment options, complete any of the following fields, then click Save changes at the bottom of the page:

  • Additional prompt: Use natural language to identify your preferences, such as corporate style guidelines and the inclusion or exclusion of specific words.

  • Segmentation: This section includes a list of all product categories in your source feed. Select one or more categories to limit the enrichment to only products in those categories. All other categories will not be enriched when you have one or more categories selected here.

  • Price range: Identify a minimum price in the field on the left and maximum price in the field on the right to only enrich products with prices within that range. The range uses the currency identified in the feed source details; do not include currency symbols in these fields.

The enrichment process begins after the enrichment configuration and feed ingestion are complete.


See also:

Did this answer your question?