Skip to content

docs: add AI agents guide#995

Open
vdusek wants to merge 8 commits into
masterfrom
docs/ai-agents-guide
Open

docs: add AI agents guide#995
vdusek wants to merge 8 commits into
masterfrom
docs/ai-agents-guide

Conversation

@vdusek

@vdusek vdusek commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Add a guide on hosting AI agents as Apify Actors.

Each of the five supported frameworks (LangGraph, CrewAI, PydanticAI, LlamaIndex, and Smolagents) gets a complete, runnable single-file Actor example. Every example routes its LLM calls through the Apify OpenRouter proxy, so no provider API key is needed and each one runs as a "Run on Apify" example. The guide also covers choosing a framework, connecting to an LLM, using Apify Actors as agent tools, and monetizing with pay-per-event. Every framework links to its matching Actor template.

The new guide is also linked from the README, the overview, and the quick start.

@vdusek vdusek added adhoc Ad-hoc unplanned task added during the sprint. t-tooling Issues with this label are in the ownership of the tooling team. labels Jun 17, 2026
@vdusek vdusek self-assigned this Jun 17, 2026
@github-actions github-actions Bot added this to the 143rd sprint - Tooling team milestone Jun 17, 2026
@codecov

codecov Bot commented Jun 17, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.69%. Comparing base (da56837) to head (fd91257).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master     #995      +/-   ##
==========================================
- Coverage   91.75%   91.69%   -0.07%     
==========================================
  Files          50       50              
  Lines        3215     3215              
==========================================
- Hits         2950     2948       -2     
- Misses        265      267       +2     
Flag Coverage Δ
e2e 35.64% <ø> (ø)
integration 57.38% <ø> (ø)
unit 83.01% <ø> (-0.07%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@vdusek vdusek force-pushed the docs/ai-agents-guide branch 2 times, most recently from 84b618c to 1bb3288 Compare June 17, 2026 12:06
@vdusek vdusek force-pushed the docs/ai-agents-guide branch from 1bb3288 to 034a077 Compare July 3, 2026 08:18
@vdusek vdusek added the documentation Improvements or additions to documentation. label Jul 3, 2026
@vdusek vdusek marked this pull request as ready for review July 3, 2026 15:25
@vdusek vdusek requested a review from szaganek as a code owner July 3, 2026 15:25
Comment thread docs/03_guides/14_ai_agents.mdx Outdated
Comment thread docs/03_guides/14_ai_agents.mdx Outdated
Comment thread docs/03_guides/14_ai_agents.mdx Outdated
Comment thread docs/03_guides/14_ai_agents.mdx Outdated
Comment thread docs/03_guides/14_ai_agents.mdx
Comment thread docs/03_guides/14_ai_agents.mdx Outdated
Comment thread docs/03_guides/14_ai_agents.mdx Outdated
Comment thread docs/03_guides/14_ai_agents.mdx Outdated

An agent becomes useful once it can act on the world. On Apify, any of the thousands of Actors in the [Apify Store](https://apify.com/store) can become a tool: a scraper that fetches data, a browser automation that fills a form, or an API wrapper that posts a message.

Some frameworks ship a ready-made wrapper for this. For LangGraph and other [LangChain](https://www.langchain.com/)-based agents, the [`langchain-apify`](https://github.com/apify/langchain-apify) package exposes any Actor as a tool with a single line:

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.

We can't leave a single this dangling like that, we need to specify what this is.

Comment thread docs/03_guides/14_ai_agents.mdx Outdated

## Running on the Apify platform

Agents run on the standard [Apify Python base image](https://hub.docker.com/r/apify/actor-python), so no browser or extra system dependencies are needed. Add `apify` and the packages shown in your framework's section above to `requirements.txt`, then deploy the Actor as usual.

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.

Suggested change
Agents run on the standard [Apify Python base image](https://hub.docker.com/r/apify/actor-python), so no browser or extra system dependencies are needed. Add `apify` and the packages shown in your framework's section above to `requirements.txt`, then deploy the Actor as usual.
Agents run on the standard [Apify Python base image](https://hub.docker.com/r/apify/actor-python), so no browser or extra system dependencies are needed. Add `apify` and the packages required by your framework to `requirements.txt`, then deploy the Actor as usual.

Please verify my guess. I honestly don't know what section it refers to.

Comment thread docs/03_guides/14_ai_agents.mdx Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint. documentation Improvements or additions to documentation. t-tooling Issues with this label are in the ownership of the tooling team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants