Skip to content

docs: add Develop AI agents on Apify page#2375

Draft
marcel-rbro wants to merge 3 commits intomasterfrom
docs/develop-ai-agents-page
Draft

docs: add Develop AI agents on Apify page#2375
marcel-rbro wants to merge 3 commits intomasterfrom
docs/develop-ai-agents-page

Conversation

@marcel-rbro
Copy link
Copy Markdown
Contributor

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>
@github-actions github-actions bot added the t-docs Issues owned by technical writing team. label Mar 27, 2026
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@apify-service-account
Copy link
Copy Markdown

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

@apify-service-account
Copy link
Copy Markdown

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

Copy link
Copy Markdown
Contributor

@MQ37 MQ37 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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


### Example workflow

1. Your agent Actor starts AI Sandbox as a sub-Actor
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: what is "sub-Actor"? I would explain this term as it is not coined term as for example sub-agent.


:::

## Access LLMs with OpenRouter
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here I would mention that we recommend to subscribe and be a paying user in order to use this Actor as some free users might be blocked because of the anti-fraud logic.

@jirispilka jirispilka self-requested a review March 31, 2026 06:55
Copy link
Copy Markdown
Contributor

@jirispilka jirispilka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

It would clearly deserve a bit more explanations and context.

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).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When you mention full stack, people will typically trigger frontend, backend. I know what you mean but maybe we can choose different wording.


## Start from a template

The fastest way to start your AI agent is to use one of the AI framework templates. Each template comes pre-configured with the right file structure, dependencies, and the Apify SDK integration.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"AI framework templates" - for the first time reader, you need to explain what is "AI framework templates". This is Apify Actor templates, right?

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).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants