Apify Integration

The Newsletter AI Agent is implemented as an Apify Actor, which means it runs on the Apify platform and can be accessed through Apify’s API.

Setting Up Apify

To use the Newsletter AI Agent, you’ll need an Apify account and API key:

Sign up for an Apify account if you don’t have one
Navigate to your Account Settings to find your API key
Store your API key securely

Required Environment Variables

The Newsletter AI Agent requires the following environment variables:

# In your .env file
APIFY_API_KEY=your_apify_api_key_here
GOOGLE_API_KEY=your_google_api_key_here

Running the Actor

You can run the Newsletter AI Agent in several ways:

Using the Apify Console

Navigate to the Newsletter AI Agent on the Apify platform
Configure the input parameters (topic for the newsletter)
Click “Run” to start the actor

Using the Apify API

You can also run the actor programmatically using the Apify API:

import os
from apify_client import ApifyClient

# Initialize the ApifyClient with your API token
client = ApifyClient(os.getenv('APIFY_API_KEY'))

# Start the actor and wait for it to finish
run = client.actor('your-username/newsletter-ai-agent').call({
    'topic': 'AI advancements in healthcare'
})

# Fetch the actor's output
output = client.dataset(run['defaultDatasetId']).list_items().items[0]
newsletter_content = output['content']
print(newsletter_content)

Input Parameters

The Newsletter AI Agent accepts the following input parameters:

Parameter	Type	Description	Required
`topic`	string	The topic for the newsletter	Yes

Output Format

The actor outputs the generated newsletter in Markdown format, along with metadata:

{
  "topic": "AI advancements in healthcare",
  "content": "# AI in Healthcare Newsletter\n\n...",
  "status": "success",
  "timestamp": "2023-01-01T12:00:00Z"
}

Error Handling

If an error occurs during newsletter generation, the actor will output an error message:

{
  "topic": "AI advancements in healthcare",
  "error": "Error in newsletter generation: ...",
  "status": "error",
  "timestamp": "2023-01-01T12:00:00Z"
}

Rate Limiting

Usage of the Newsletter AI Agent is subject to Apify’s rate limiting and pricing. Please refer to the Apify pricing page for more information.

Next Steps

Learn about the agents that power the Newsletter AI Agent
Explore the tools used by the agents
See how the Newsletter AI Agent generates newsletters

​Apify Integration

​Setting Up Apify

​Required Environment Variables

​Running the Actor

​Using the Apify Console

​Using the Apify API

​Input Parameters

​Output Format

​Error Handling

​Rate Limiting

​Next Steps