kick off a stub of the AI course

Author: honzajavorek

sources/academy/platform/building_actors_with_ai/01_chatting.md

@@ -0,0 +1,42 @@
+---
+title: Chatting to code
+description: TBD
+slug: /building-actors-with-ai/chatting
+unlisted: true
+---
+
+<!--
+Copying from chat, pasting to local files. Running with uv (should be easy-ish?). Creating a basic scraper which does what we need.
+
+The first lesson should use ChatGPT. It's mainstream. For chatting, it's free with limits, but many people might already pay for it, and for those it's gonna be without perceivable limits.
+
+The implementation language can be JS or Python, it doesn't matter. However, the apify create template for Python is outdated, so I think (with a tear in my eye) that we should generate JavaScript – compared to outdated Python stack, I expect less issues to run it locally.
+
+Start by explaining why running a scraper as an Actor makes sense (execution, storage, scheduling, history), and then install the CLI and use the template with those benefits in mind.
+
+In lesson 1, students would work inside the template by copying/pasting from ChatGPT and focus on getting their first scraper working, without worrying too much about anything else.
+-->
+
+:::note Course under construction
+
+This page hasn't been written yet. Come later, please!
+
+:::
+
+
+<!--
+#### Creating first scraper
+Prompt ChatGPT to get a simple JavaScript program which downloads https://warehouse-theme-metal.myshopify.com/collections/sales and lists the product names:
+
+> Create a scraper in JavaScript which downloads https://warehouse-theme-metal.myshopify.com/collections/sales, extracts all the products in Sales and saves a CSV file, which contains:
+> - Product name
+> - Product detail page URL
+> - Price
+
+#### Running code
+Save it as a scraper.js, setup Node/npm environment, run it, get results. If the student gets stuck setting up Node/npm, they ask ChatGPT. Roughly explaining what the program does, establishing basic terms.
+#### Scraping stock units
+Prompt ChatGPT to modify the program so that it scrapes stock units. Technically, modifying the program like this proves to be cumbersome, but doable. Run the program again, get better results.
+
+Teaser: In the next lesson we'll get rid of copying and pasting and updating the files ourselves.
+-->

sources/academy/platform/building_actors_with_ai/02_using_platform.md

@@ -0,0 +1,28 @@
+---
+title: Using a platform
+description: TBD
+slug: /building-actors-with-ai/using_platform
+unlisted: true
+---
+
+<!--
+Deploying to Apify and reaping the benefits of the platform. Running the scraper periodically, adding support for proxies...
+
+In lesson 2, students could already push the Actor to Apify and start seeing some of the platform benefits.
+-->
+
+:::note Course under construction
+
+This page hasn't been written yet. Come later, please!
+
+:::
+
+
+<!--
+#### Creating an Actor
+Explain what is Actor. Use Apify CLI template - already provides AGENTS.md, README.md, all the basics. Get the Apify CLI and use it to start a new project. Explain that this is how a professional scraper should be started.
+#### Turning the Actor to a scraper
+Take contents of the old README to the template and tests and let the agent implement the same scraper again according to all of that. Explain that this is the shortest and most robust way from idea to result - use template, provide docs, tests, and let the agent do its job.
+#### Deploying
+Deploying to Apify and reaping the benefits of the platform. Running the scraper periodically, getting JSONs and CSVs, seeing history, monitoring, adding support for proxies...
+-->

sources/academy/platform/building_actors_with_ai/03_using_agent.md

@@ -0,0 +1,31 @@
+---
+title: Using an agent
+description: TBD
+slug: /building-actors-with-ai/using-agent
+unlisted: true
+---
+
+<!--
+Explaining benefits (delegation and independent work, AGENTS.md). Getting environment ready, learning the ropes with a GUI/TUI. Using the `apify` CLI to start a project. Creating a basic scraper which does what we need.
+
+In lesson 3, students would try to make changes via ChatGPT and see that it gets tedious, which leads to introducing an agent-based IDE to work inside the template more comfortably.
+
+The lesson should use Cursor (or Google Antigravity). Only if it truly scales to zero as they claim and it is not required to have a paid account to try an agent. Minimal friction, just install – beats any other decision factors.
+
+If the paragraph above turns out being a wrong direction, we should use VS Code and tell people to spend $10 to try Copilot. VS Code is mainstream. Paying for Copilot is the cheapest agent offering, and it's quite powerful.
+-->
+
+:::note Course under construction
+
+This page hasn't been written yet. Come later, please!
+
+:::
+
+<!--
+#### Installing development environment
+Explaining benefits (delegation and independent work, AGENTS.md). Getting environment ready. Use https://docs.apify.com/platform/actors/development/quick-start/build-with-ai
+#### Scraping vendor names
+Learning the ropes with a GUI/TUI, prompting the agent to update the code so that it scrapes vendor names. Run the program again, get better results.
+
+Teaser: Explain why this is fragile. In the next lesson we'll learn how to develop features of the scraper in a robust way by first specifying them as documentation.
+-->

sources/academy/platform/building_actors_with_ai/04_docs_driven_prompting.md

@@ -0,0 +1,29 @@
+---
+title: Tests driven prompting
+description: TBD
+slug: /building-actors-with-ai/tests-driven-prompting
+unlisted: true
+---
+
+<!--
+Adding fixtures, expectations. Setting up tests and teaching the agent to run tests. Dealing with corner cases by pointing the agent to the fixtures.
+
+In lesson 3, students would try to make changes via ChatGPT and see that it gets tedious, which leads to introducing an agent-based IDE to work inside the template more comfortably.
+-->
+
+:::note Course under construction
+
+This page hasn't been written yet. Come later, please!
+
+:::
+
+<!--
+#### Creating README.md
+Create simple README.md where we document how the scraper behaves, what it produces as an output, etc. Primer to Markdown.
+#### Dealing with price intervals
+Explain focus on product and domain knowledge. In the README explain how the scraper should handle prices like "From $1,398.00", introduce minPrice, keep prices as numbers, etc.
+
+Let the agent implement handling of variants based on the README. Run updated code, see results.
+
+Teaser: Imagine the target website changes something (happens often!). In such case the README won't help. Let's deal with that.
+-->

sources/academy/platform/building_actors_with_ai/05_tests_driven_prompting.md

@@ -0,0 +1,26 @@
+---
+title: Docs driven prompting
+description: TBD
+slug: /building-actors-with-ai/tests-driven-prompting
+unlisted: true
+---
+
+<!--
+Improving the README, e.g. input output. Pointing the agent to the README and turning the design to reality.
+-->
+
+:::note Course under construction
+
+This page hasn't been written yet. Come later, please!
+
+:::
+
+
+<!--
+#### Creating tests
+Explain tests, expectations. Create test folder, drop downloaded HTML of the listing there, let the agent set up tests around it. Let the agent run tests.
+#### Scrape product variants
+Change README so that it describes how the product variants should be handled. Drop HTML of the product detail page to the tests folder. Prompt the agent to implement scraping product variants. Run the program, get results.
+
+Teaser: In the next lesson we'll learn how to deploy a similar scraper to a platform, schedule it to run regularly, automatically produce various formats, have a history of data, etc.
+-->

sources/academy/platform/building_actors_with_ai/06_publishing.md

@@ -0,0 +1,22 @@
+---
+title: Publishing to Apify Store
+description: TBD
+slug: /building-actors-with-ai/publishing-to-store
+unlisted: true
+---
+
+<!--
+The last lesson could focus more on quality, maintainability, and also touch on the Apify Store.
+
+It won't include the publishing itself, but will cover most of any 'tidying up' needed before one actually goes to publish an Actor for others to use.
+-->
+
+:::note Course under construction
+
+This page hasn't been written yet. Come later, please!
+
+:::
+
+<!--
+TBD
+-->

sources/academy/platform/building_actors_with_ai/index.md

@@ -0,0 +1,40 @@
+---
+title: Building Actors with AI
+description: Learn how to use AI to extract information from websites in this practical course, starting from the absolute basics.
+sidebar_position: 5
+sidebar_label: Building Actors with AI
+category: apify platform
+slug: /building-actors-with-ai
+unlisted: true
+---
+
+import DocCardList from '@theme/DocCardList';
+
+**Learn how to use AI to extract information from websites in this practical course, starting from the absolute basics.**
+
+---
+
+In this course we'll use AI assistants to create an application for watching prices. It'll be able to scrape all product pages of an e-commerce website and record prices. Data from several runs of such program would be useful for seeing trends in price changes, detecting discounts, etc.
+
+The end product will, unlike programs vibe-coded carelessly, reach the level of quality allowing for further extensibility and comfortable maintenance, so that it can be published to [Apify Store](https://apify.com/store).
+
+## What we'll do
+
+- Use ChatGPT (AI chat) to create a program which extracts data from a web page.
+- Save extracted data in various formats, e.g. CSV which MS Excel or Google Sheets can open.
+- Use Cursor (AI agent) to improve the program so that it is robust and maintainable.
+- Save time and effort with Apify's scraping platform.
+
+## Who this course is for
+
+Anyone with basic knowledge of chatting with an AI assistant and affinity to building digital products who wants to start with web scraping can take this course. The course does not expect you to have any prior knowledge of web technologies or scraping.
+
+## Requirements
+
+- Prior experience chatting with AI assistants, such as OpenAI ChatGPT, Google Gemini, or Anthropic Claude.
+- A macOS, Linux, or Windows machine. If it's your work computer, make sure you have permissions to install new software.
+- Familiarity with running commands in Terminal (macOS/Linux) or Command Prompt (Windows). Just generally knowing what those are and how to use them is sufficient.
+
+## Course content
+
+<DocCardList />