Skip to content

docs: Refactor of Build with AI section #2044

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 13 commits into from
Oct 30, 2025
Merged

docs: Refactor of Build with AI section #2044

merged 13 commits into from
Oct 30, 2025

Conversation

@patrikbraborec
Copy link
Contributor

@patrikbraborec patrikbraborec commented Oct 25, 2025 •
edited
Loading

I refactored the page and added instructions on "how to start building actors with AI".

Basically, the idea is to provide an environment for "vibe coders", where they just copy and paste the instructions to AI, and the AI will create an actor together with AGENTS.md.

Key decisions and comments:

  • I ignored the apify create command and instead provided the LLM with the actor structure with key details for actor.json, etc. It works pretty well.
  • I tested it, and I successfully built the actor several times. It also created the correct AGENTS.md, and I was able to push the Actor to the Console and run it.
  • The next improvement regarding the AGENTS.md/instructions should be done with the help of some kind of evals to systematically improve the AGENTS.md/instructions rather than guessing what might work.
  • I added links to install MCP through a button. There is a problem with Auth (our MCP requires Auth even for docs). If we do not solve the issue, I will just add a link to mcp.apify.com for now and add the buttons later.

@patrikbraborec patrikbraborec requested a review from TC-MO as a code owner October 25, 2025 10:41
@github-actions github-actions bot added the t-c&c Team covering store and finance matters. label Oct 25, 2025
@apify-service-account
Copy link

apify-service-account commented Oct 25, 2025

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

@apify-service-account
Copy link

apify-service-account commented Oct 25, 2025

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

@apify-service-account
Copy link

apify-service-account commented Oct 26, 2025

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

@apify-service-account
Copy link

apify-service-account commented Oct 26, 2025

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

@patrikbraborec patrikbraborec force-pushed the docs/build-with-ai-refactor branch from b94aa86 to 5707fe5 Compare October 28, 2025 12:47
@patrikbraborec
Copy link
Contributor Author

patrikbraborec commented Oct 28, 2025

I kept the Install button, but changed the Build with AI section that talks about MCP. Once we have an MCP server without Auth for docs, we can just use the buttons.

@apify-service-account
Copy link

apify-service-account commented Oct 28, 2025

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

@apify-service-account
Copy link

apify-service-account commented Oct 28, 2025

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

TC-MO
TC-MO requested changes Oct 29, 2025
View reviewed changes
jirispilka
jirispilka requested changes Oct 29, 2025
View reviewed changes
Copy link
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 left a couple of comments, nothing serious but IMO it would be good to fix some of the issues.

@patrikbraborec @jirispilka @TC-MO
Apply suggestions from code review
597bdbb 
Co-authored-by: Jiří Spilka <jiri.spilka@apify.com>
Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
@apify-service-account
Copy link

apify-service-account commented Oct 29, 2025

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

@apify-service-account
Copy link

apify-service-account commented Oct 29, 2025

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

@apify-service-account
Copy link

apify-service-account commented Oct 29, 2025

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

@patrikbraborec
Copy link
Contributor Author

patrikbraborec commented Oct 29, 2025

@TC-MO, @jirispilka I went through your comments, and fixed most of them. Please check it - if you are OK with it, just approve the PR so I can merge it, thanks!

TC-MO
TC-MO reviewed Oct 29, 2025
View reviewed changes
patrikbraborec and others added 2 commits October 29, 2025 19:51
@patrikbraborec @TC-MO
Update sources/platform/actors/development/quick_start/build_with_ai.md
ba02668 
Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
@patrikbraborec
docs: Fix PR comments
0077a45
@apify-service-account
Copy link

apify-service-account commented Oct 29, 2025

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

@apify-service-account
Copy link

apify-service-account commented Oct 29, 2025

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

TC-MO
TC-MO approved these changes Oct 29, 2025
View reviewed changes
Copy link
Contributor

@TC-MO TC-MO left a comment

Choose a reason for hiding this comment

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

LGTM

jirispilka
jirispilka approved these changes Oct 29, 2025
View reviewed changes
Copy link
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.

Looks good to me. Thanks!

I've introduced a capital Docs, it should be reference Apify docs
If you can commit that as well, please

patrikbraborec and others added 2 commits October 30, 2025 09:03
@patrikbraborec @jirispilka
Update sources/platform/actors/development/quick_start/build_with_ai.md
7b9c94d 
Co-authored-by: Jiří Spilka <jiri.spilka@apify.com>
@patrikbraborec @jirispilka
Update sources/platform/actors/development/quick_start/build_with_ai.md
1d1d23c 
Co-authored-by: Jiří Spilka <jiri.spilka@apify.com>
@apify-service-account
Copy link

apify-service-account commented Oct 30, 2025

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

1 similar comment
@apify-service-account
Copy link

apify-service-account commented Oct 30, 2025

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

@patrikbraborec patrikbraborec merged commit f179e24 into master Oct 30, 2025
9 checks passed
@patrikbraborec patrikbraborec deleted the docs/build-with-ai-refactor branch October 30, 2025 08:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jirispilka jirispilka jirispilka approved these changes

@TC-MO TC-MO TC-MO approved these changes

@lukas-bekr lukas-bekr Awaiting requested review from lukas-bekr

Assignees

@patrikbraborec patrikbraborec

Labels

t-c&c Team covering store and finance matters.

Projects

None yet

Milestone

126th sprint - Cash & Community team

Development

Successfully merging this pull request may close these issues.

5 participants

@patrikbraborec @apify-service-account @jirispilka @TC-MO