docs: add Develop AI agents on Apify page by marcel-rbro · Pull Request #2375 · apify/apify-docs

marcel-rbro · 2026-03-27T10:40:16Z

Summary

New page "Develop AI agents on Apify" at /actors/development/quick-start/develop-ai-agents covering the full AI agent development stack: AI templates, AI Sandbox, OpenRouter LLM access, pay-per-event monetization, and deployment
Cross-link added from existing "Build with AI" page to the new page
Distinct from "Build with AI" (which covers using AI coding assistants) — this page is about building AI agent products that run on Apify

Open questions

Token usage tracking: How to extract token counts from OpenRouter responses for PPE per-token charging (flagged with a caution admonition in the draft)
AI Sandbox details: Content based on Actor README + Dusan's brainstorm — needs review from the sandbox team
OpenRouter: First standalone explanation in docs — verify accuracy with the team

Test plan

Preview build renders the page correctly
Sidebar shows "Develop AI agents" after "Build with AI"
All internal and external links work
Linting passes (npm run lint:md ✅)

🤖 Generated with Claude Code

New page covering the full AI agent development stack on Apify: templates, AI Sandbox, OpenRouter LLM access, PPE monetization, and deployment. Cross-links from existing "Build with AI" page. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

apify-service-account · 2026-03-27T10:50:29Z

Preview for this PR was built for commit 5cf0324 and is ready at https://pr-2375.preview.docs.apify.com!

apify-service-account · 2026-03-27T11:06:36Z

Preview for this PR was built for commit b5e15e5 and is ready at https://pr-2375.preview.docs.apify.com!

MQ37

Quickly went through it and looks good, only two comments 👍

jirispilka

I believe this is an initial version that we plan to expand later on?

It would clearly deserve a bit more explanations and context.

jirispilka · 2026-03-31T07:00:17Z

+slug: /actors/development/quick-start/develop-ai-agents
+---
+
+The Apify platform provides everything you need to build, test, and deploy AI agents. This page walks you through the full stack: templates, sandbox code execution, LLM access through OpenRouter, pay-per-event monetization, and deployment to [Apify Store](https://apify.com/store).


An image that would connect all these things together would be nice. It would guide me through the docs page easily. Otherwise it is a bit difficult to connect the dots. For example, you don't need sandbox at all, so you should give people an idea where they can use it

apify-service-account · 2026-04-01T14:06:56Z

Preview for this PR was built for commit 29c6b461 and is ready at https://pr-2375.preview.docs.apify.com!

apify-service-account · 2026-04-02T20:29:39Z

Preview for this PR was built for commit e4b2b453 and is ready at https://pr-2375.preview.docs.apify.com!

vystrcild · 2026-04-14T07:34:07Z

Sorry, guys - I didn't realize you put your comments here :(
I see @marcel-rbro already fix those - so could we release this first version and then iterate if necessary?

marcel-rbro · 2026-04-14T11:33:49Z

I have the note that I need to create the diagram and add more details in my backlog, but it's true that there's no need to block this task. @jirispilka @TC-MO final review please so we can ship this?

jirispilka

I'd release it, later we should fixed the things that @marcel-rbro has in the backlog.

At high level, it reads like unrelated things stitched together without paying much attention to the developer journey.

Even one paragraph that ties it all together might help

TC-MO

A few things I noticed, plus one structural point.

Other quick-starts (with exception of Build with AI) open with a Prerequisites section. This page skips it, but assumes the reader already has:
- An Apify account
- The Apify CLI installed
- An APIFY_TOKEN environment variable set

The CLI and account are at least mentioned inline later, but APIFY_TOKEN appears in the OpenRouter code example without any setup context. Consider adding a short prerequisites block to match the pattern in the other quick-start pages.

apify-service-account · 2026-04-15T12:30:57Z

Preview for this PR was built for commit 1ccdc83e and is ready at https://pr-2375.preview.docs.apify.com!

TC-MO

Please add the specific Python version I think it's important info especially since different versions have different features.

Otherwise LGTM

apify-service-account · 2026-04-15T13:23:00Z

Preview for this PR was built for commit d5340704 and is ready at https://pr-2375.preview.docs.apify.com!

github-actions bot assigned marcel-rbro Mar 27, 2026

github-actions bot added the t-docs Issues owned by technical writing team. label Mar 27, 2026

fix: use /platform prefix for internal doc links

5cf0324

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

small fixes

b5e15e5

MQ37 reviewed Mar 30, 2026

View reviewed changes

Comment thread sources/platform/actors/development/quick-start/develop_ai_agents.md Outdated

Comment thread sources/platform/actors/development/quick-start/develop_ai_agents.md

jirispilka self-requested a review March 31, 2026 06:55

jirispilka requested changes Mar 31, 2026

View reviewed changes

Merge branch 'master' into docs/develop-ai-agents-page

29c6b46

docs: enhance clarity and detail in the AI agents development guide

e4b2b45

marcel-rbro requested a review from jirispilka April 14, 2026 11:31

marcel-rbro marked this pull request as ready for review April 14, 2026 11:32

marcel-rbro requested a review from TC-MO as a code owner April 14, 2026 11:32

jirispilka approved these changes Apr 14, 2026

View reviewed changes

TC-MO requested changes Apr 14, 2026

View reviewed changes

partial review

1ccdc83

marcel-rbro requested a review from TC-MO April 15, 2026 12:36

TC-MO approved these changes Apr 15, 2026

View reviewed changes

marcel-rbro added 2 commits April 15, 2026 15:18

fix py version

ebe1046

Merge branch 'master' into docs/develop-ai-agents-page

d534070

marcel-rbro mentioned this pull request Apr 15, 2026

Improve "Develop AI agents on Apify" page #2436

Open

marcel-rbro merged commit bc909c8 into master Apr 15, 2026
13 checks passed

marcel-rbro deleted the docs/develop-ai-agents-page branch April 15, 2026 13:21

Conversation

marcel-rbro commented Mar 27, 2026

Summary

Open questions

Test plan

Uh oh!

apify-service-account commented Mar 27, 2026

Uh oh!

apify-service-account commented Mar 27, 2026

Uh oh!

MQ37 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

jirispilka left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

jirispilka Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Apr 1, 2026

Uh oh!

apify-service-account commented Apr 2, 2026

Uh oh!

vystrcild commented Apr 14, 2026

Uh oh!

marcel-rbro commented Apr 14, 2026

Uh oh!

jirispilka left a comment

Choose a reason for hiding this comment

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Apr 15, 2026

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

apify-service-account commented Apr 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants