Skip to content

Commit 731c1c6

Browse files
authored
Update AI pages to tell about the new AI agent
1 parent 0f263ac commit 731c1c6

File tree

7 files changed

+125
-23
lines changed

7 files changed

+125
-23
lines changed
Loading
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: Build with AI
3+
---
4+
# Build with AI: the AI agent
5+
6+
The **AI agent** is an AI specialized to build games using the GDevelop engine.
7+
8+
![A conversation with the AI agent building a feature in a game](./ai-agent-conversation.png)
9+
10+
## How to use it
11+
12+
To open Ask AI, click the "Ask AI" button in the top-right corner of the GDevelop interface. Select **"Build for me"**, then type your request and click Send — that’s it.
13+
14+
## What the AI agent can build for you
15+
16+
The AI agent has knowledge of all GDevelop features and official, reviewed extensions. It also has a view of your whole game, and can if necessary inspect your game events or scenes.
17+
18+
As with an AI powered tool, the result will vary according to what you ask. The AI agent is good for:
19+
20+
- Doing simple changes ("Make an object bigger"),
21+
- Creating new features ("Make an enemy that attacks the player"),
22+
- Experimenting ("Make the key move away from the player when they try to reach it")
23+
- Learning new concepts - by watching what the AI does for you.
24+
25+
The AI will reply in a few seconds after your request. It will then progressively take actions in your game. This can be:
26+
27+
- Creating a scene,
28+
- Adding a new object,
29+
- Adding a behavior to an object,
30+
- Creating or modifying events to build the logic of your game,
31+
- Placing game objects on the scene,
32+
- And more.
33+
34+
The AI will try to fulfill the request as much as it can. It will show on the screen a summary of everything it is doing. Some steps can also have extra details you can inspect.
35+
36+
!!! warning
37+
38+
As with every AI tool, what the AI is doing is not perfect. From time to time, it can confuse some concepts, misunderstanding your game or what you're trying to do.
39+
Always double check what the AI does: you can keep continuing as long as it looks useful or stop and rework yourself what was created.
40+
41+
42+
You can continue the conversation by asking follow-up requests. If you want to switch topics or ask something unrelated, click **"Start a new chat"** — this helps the AI better focus on your new request.
43+
44+
## Cost of an AI request
45+
46+
Each account starts with a few **free AI requests**. If you have a GDevelop Gold or Pro subscription, you’ll receive more every month — 25 with Gold and 75 with Pro.
47+
48+
!!! note
49+
50+
Once you've used all free requests, a request to the AI agent you send costs 4 to 20 credits. This means that with [a package of 500 credits](/gdevelop5/interface/profile/credits), you can make from 30 to 100 requests. Remember you can get **free credits by following GDevelop accounts** on socials — check your profile!
51+
52+
## Help us improve the AI
53+
54+
You can rate the AI’s answers with a 👍 or 👎. These ratings help the GDevelop team improve the assistant.
55+
56+
!!! note
57+
58+
Sometimes, high demand can temporarily slow things down or prevent a proper response. If that happens, don’t worry — you won’t be charged credits or lose your free requests.
394 KB
Loading
Lines changed: 20 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,24 @@
11
---
2-
title: Ask AI
2+
title: Chat with AI
33
---
4-
# Ask AI: Get Help Building Your Game with AI
4+
# Chat with AI: Get Help Building Your Game with AI
55

6-
**Ask AI** is an experimental chat assistant designed specifically to help you create your game in GDevelop.
6+
The **AI chat** is a chat assistant designed specifically to help you create your game in GDevelop.
77

8-
![Ask AI screen](./ask-ai.png)
8+
## How to use it
9+
10+
To open Ask AI, click the "Ask AI" button in the top-right corner of the GDevelop interface. Select **"Ask a question"**, then type your question and click Send — that’s it.
911

10-
Unlike general-purpose AI tools like ChatGPT, Claude, or Google Gemini, this AI is **tailored for GDevelop**. It knows how GDevelop works and can help you:
12+
The AI will reply in a few seconds. Answers often include **links to helpful resources, extensions, behaviors**, and relevant GDevelop concepts like actions or conditions.
13+
14+
!!! warning
1115

12-
- Understand features and how to use them
13-
- Build specific mechanics or systems
14-
- Explore and brainstorm new ideas
16+
As with every AI tool, the AI answers are not perfect. From time to time, it can confuse some concepts, misunderstanding your game or what you're trying to do.
17+
Always double check the answers and use the AI answers as suggestions to build your game. It's a good idea to follow the **[Complete GDevelop Master Course](https://gdevelop.io/academy)** to quickly learn the basics of GDevelop and make your first games.
1518

16-
Think of it as a mentor that speaks GDevelop fluently.
19+
You can continue the conversation by asking follow-up questions. If you want to switch topics or ask something unrelated, click **"Start a new chat"** — this helps the AI better focus on your new request.
1720

18-
## How does it work
21+
## What the AI chat can help you with
1922

2023
The AI understands all built-in GDevelop features and official, reviewed extensions (it doesn’t include community extensions unless they’ve been approved by the GDevelop team). It also has access to *an overview* of your project, which includes:
2124

@@ -26,30 +29,24 @@ The AI understands all built-in GDevelop features and official, reviewed extensi
2629

2730
It **does not** currently have access to your scene events. It also has no access or details given about your username, profile, cloud projects, leaderboards, analytics or any personal detail from your user account.
2831

29-
## How to use it
32+
The AI chat is perfect for getting a better understanding of a game develpment notion, discover extensions or features that you can use or learn how to build something.
33+
3034

31-
To open Ask AI, click the "Ask AI" button in the top-right corner of the GDevelop interface.
32-
Type your question and click Send — that’s it.
35+
## Cost of an answer from the AI
3336

34-
Each account starts with a few **free AI answers**. If you have a GDevelop Gold or Pro subscription, you’ll receive more every month — 25 with Gold and 40 with Pro. (Note that these amounts may change as we learn more about how creators use the AI.)
37+
Each account starts with a few **free AI answers**. If you have a GDevelop Gold or Pro subscription, you’ll receive more every month — 25 with Gold and 75 with Pro.
3538

3639
!!! note
3740

3841
Once you've used all free answers, a message you send to the AI costs 5 credits. This means that with [a package of 500 credits](/gdevelop5/interface/profile/credits), you can make up to 100 requests. Remember you can get **free credits by following GDevelop accounts** on socials — check your profile!
3942

4043
This is done to help pay for the expenses related to AI processing, and their maintenance.
4144

42-
The AI will reply in a few seconds. Answers often include links to helpful resources, extensions, behaviors, and relevant GDevelop concepts like actions or conditions.
43-
44-
!!! warning
45-
46-
As with every AI tool, the AI answers are not perfect. From time to time, it can confuse some concepts, misunderstanding your game or what you're trying to do.
47-
Always double check the answers and use the AI answers as suggestions to build your game. It's a good idea to follow the **[Complete GDevelop Master Course](https://gdevelop.io/academy)** to quickly learn the basics of GDevelop and make your first games.
48-
49-
You can continue the conversation by asking follow-up questions. If you want to switch topics or ask something unrelated, click Start a new chat — this helps the AI better focus on your new request.
5045

5146
## Help us improve the AI
5247

5348
You can rate the AI’s answers with a 👍 or 👎. These ratings help the GDevelop team improve the assistant.
5449

55-
Sometimes, high demand can temporarily slow things down or prevent a proper response. If that happens, don’t worry — you won’t be charged credits or lose your free requests.
50+
!!! note
51+
52+
Sometimes, high demand can temporarily slow things down or prevent a proper response. If that happens, don’t worry — you won’t be charged credits or lose your free requests.

docs/gdevelop5/interface/ai/index.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: Ask AI (build/chat with AI)
3+
---
4+
# Ask AI: Build your game with AI
5+
6+
Click on **Ask AI** on the top-right corner of GDevelop to open the GDevelop AI editor.
7+
8+
![Ask AI screen](./ask-ai-tab.png)
9+
10+
Unlike general-purpose AI tools like ChatGPT, Claude, or Google Gemini, GDevelop AI is **tailored for game creation**. It knows how GDevelop works and can help you:
11+
12+
- Understand features and how to use them
13+
- Build specific mechanics or systems
14+
- Explore, brainstorm and bring new ideas to life
15+
16+
!!! tip
17+
18+
Think of it as a mentor and creative collaborator that speaks GDevelop fluently.
19+
20+
## How does it work: AI agent and AI chat
21+
22+
The AI understands all built-in GDevelop features and official, reviewed extensions (it doesn’t include community extensions unless they’ve been approved by the GDevelop team). It can also read the content of your game project when you ask it to build something for you.
23+
24+
The AI has two operating modes:
25+
26+
- **[Build for me (AI agent)](./agent)**: the AI will build your request inside your game. This can range from simple changes ("Make this object bigger") to more complex requests ("Create an enemy that attack my player when approaching them").
27+
- **[Ask a question (AI chat)](./chat)**: the AI will answer any question you ask it about game development and usage of GDevelop.
28+
29+
[Learn more about the GDevelop AI agent](./agent){ .md-button .md-button--primary .full-width }
30+
31+
[Learn more about the GDevelop AI chat](./chat){ .md-button .full-width }
32+
33+
34+
## About privacy
35+
36+
GDevelop AI is **not trained on your game projects** - be it local or cloud projects. Cloud projects are stored separately from the GDevelop AI infrastructure and the AI has no access to them.
37+
38+
GDevelop AI is built on general purpose Large Language Models that we can be adapted, fine tuned or have internally multiple agents working on a request. In all cases there is no usage of private data for improving the AI.
39+
40+
## Help us improve the AI
41+
42+
You can rate the AI’s answers with a 👍 or 👎. These ratings help the GDevelop team improve the assistant.
43+
44+
!!! note
45+
46+
Sometimes, high demand can temporarily slow things down or prevent a proper response. If that happens, don’t worry — you won’t be charged credits or lose your free requests.
-352 KB
Binary file not shown.

mkdocs.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,7 @@ plugins:
108108
"gdevelop5/publishing/android_and_ios/index.md": "gdevelop5/publishing/android/index.md"
109109
"gdevelop5/publishing/android_and_ios/play-store/index.md": "gdevelop5/publishing/android/play-store/index.md"
110110
"gdevelop5/publishing/android_and_ios/play-store/upgrading-from-apk-to-aab.md": "gdevelop5/publishing/android/play-store/upgrading-from-apk-to-aab.md"
111+
"gdevelop5/interface/ask-ai": "gdevelop5/interface/ai/index.md"
111112
# Tutorials
112113
"gdevelop5/tutorials/platformer/start.md": "gdevelop5/tutorials/platformer/index.md"
113114
"gdevelop5/tutorials/asteroids/start.md": "gdevelop5/tutorials/asteroids/index.md"

0 commit comments

Comments
 (0)