docs: add Apify for AI agents onboarding page#2532
Conversation
Consolidates PRs #2367 and #2369 into one entry point for developers integrating AI agents with Apify. Covers MCP, Agent Skills, client libraries, CLI, and REST API. Wires the page into discovery surfaces: homepage card, AI integrations section card, and a disambiguation tip on the build-with-AI page. Bumps MCP to sidebar position 0 so it remains the top item in AI integrations with onboarding sitting right below.
…hooks pointer Adds three pieces an agent developer needs but the initial merge missed: - Run-your-first-Actor walkthrough with MCP, JavaScript, and Python tabs - shows the shape of an integration before the comparison table - Cost controls callout naming the four run-limit query parameters (memory, timeout, maxItems, maxTotalChargeUsd) - the most common surprise-bill footgun for autonomous agents - Webhooks pointer for long-running Actors - avoids polling when the sync endpoint times out Also links named endpoints and MCP tools where they were previously bare code spans.
- Bold reserved for UI elements; non-UI emphasis uses italic - "Sign up to Apify Console" instead of URL or specific OAuth providers - Sample agent prompt as a text code block, not a blockquote - Promote bold/italic-paragraph leads to real headings, with MCP setup rewritten as numbered procedures - Move Agent Skills out of the integration-method comparison into its own section; reframe as a layer on top of MCP or coding assistants - Link each endpoint in the REST quick-reference table to its API doc - Remove maxItems from cost controls (pay-per-result is deprecated) - Dissolve the FAQ - each entry now covered inline or by structure
TC-MO
added
documentation
|
🗑️ Preview for this PR was deleted. |
Vocab listed `serverless` as lowercase-only, blocking canonical phrasing at sentence starts. Match the [Ss]torages / [Aa]utoscaling pattern so both cases pass Vale. Restore "Serverless cloud programs" in the agent onboarding bullet.
|
I think the the page is good, only few points below: The page is quite buried in In the section I miss Apify CLI. In the section Choose your integration method -> CLI: npm install -g apify-cli # or: brew install apify-cliThe recommended version is curl. You can show https://docs.apify.com/cli/docs/reference#apify-actors-search as Discover Actors flow. Side note -> it looks that we have three similar things:
There are some differences, but it's somehow related, and I have feeling that we are duplicating content. I would rather have one GOOD thing / section than multiple of these resources across the docs. That being said, it might get solved by restructuring. |
|
Yes this is prime candidate for |
|
re: duplicated content There's real overlap between this page, I want to handle the dedup in a follow-up rather than expand this PR's scope. Long-term, this page should be the canonical reference for "Apify + AI agents", absorbing |
- Add CLI tab to the walkthrough alongside MCP/JS/Python - Lead the install command with curl per CLI README ordering; link to the full install docs for Homebrew/Windows/npm alternatives - Add `apify actors search` to the discovery flow
3 participants
Consolidates PRs #2367 and #2369 into one entry point for developers integrating AI agents with Apify. Covers MCP, Agent Skills, client libraries, CLI, and REST API.
Wires the page into discovery surfaces: homepage card, AI integrations section card, and a disambiguation tip on the build-with-AI page.
Bumps MCP to sidebar position 0 so it remains the top item in AI integrations with onboarding sitting right below.