Merge pull request #330 from devforth/docs-for-the-bulk-ai-flow

docs: update docs for bulk-ai-flow

Author: ivictbor

adminforth/documentation/docs/tutorial/07-Plugins/17-bulk-ai-flow.md

@@ -177,3 +177,90 @@ export const admin = new AdminForth({
 ![alt text](Bulk-vision-2.png)
 6. Save changhes
 ![alt text](Bulk-vision-3.png)
+
+
+## Text-to-Text Processing
+This is the most basic plugin usage. You can connect any text completion adapter to fill one or several string/number/boolean fields from other fields.
+
+### Example: Translate Names to English
+Normalize user names by translating them from any language to English for internal processing.
+
+```ts
+import CompletionAdapterOpenAIChatGPT from '@adminforth/completion-adapter-open-ai-chat-gpt/index.js';
+
+// Add to your resource plugins array
+new BulkAiFlowPlugin({
+  actionName: 'Translate surnames',
+  textCompleteAdapter: new CompletionAdapterOpenAIChatGPT({
+    openAiApiKey: process.env.OPENAI_API_KEY as string,
+    model: 'gpt-4o',
+    expert: {
+      temperature: 0.7
+    }
+  }),
+  fillPlainFields: {
+    'full_name_en': 'Translate this name to English: {{users_full_name}}',
+  },
+}),
+```
+
+## Image-to-Text Analysis (Vision)
+Analyze images and extract information to fill text, number, enum, or boolean fields.
+
+### Example: Age Detection from Photos
+
+```ts
+import AdminForthImageVisionAdapterOpenAi from '@adminforth/image-vision-adapter-openai/index.js';
+
+// Add to your resource plugins array
+new BulkAiFlowPlugin({
+  actionName: 'Guess age',
+  visionAdapter: new AdminForthImageVisionAdapterOpenAi({
+    openAiApiKey: process.env.OPENAI_API_KEY as string,
+    model: 'gpt-4.1-mini',
+  }),
+  fillFieldsFromImages: { 
+    'age': 'Analyze the image and estimate the age of the person. Return only a number.',
+  },
+  attachFiles: async ({ record }) => {
+    return [`https://users-images.s3.eu-north-1.amazonaws.com/${record.image_url}`];
+  },
+}),
+```
+
+## Text-to-Image generation or image editing
+Generate new images based on existing data and/or images using AI image generation adapters.
+
+### Example: Creating Cartoon Avatars
+
+```ts
+import ImageGenerationAdapterOpenAI from '@adminforth/image-generation-adapter-openai/index.js';
+
+// Add to your resource plugins array
+new BulkAiFlowPlugin({
+  actionName: 'Generate cartoon avatars',
+  imageGenerationAdapter: new ImageGenerationAdapterOpenAI({
+    openAiApiKey: process.env.OPENAI_API_KEY as string,
+    model: 'gpt-image-1',
+  }),
+  attachFiles: async ({ record }) => {
+    return [`https://bulk-ai-flow-playground.s3.eu-north-1.amazonaws.com/${record.users_photo}`];
+  },
+  generateImages: {
+    users_avatar: {
+      prompt: 'Transform this photo into a cartoon-style avatar. Maintain the person\'s features but apply cartoon styling. Do not add text or logos.',
+      outputSize: '1024x1024',
+      countToGenerate: 2,
+      rateLimit: '3/1h'
+    },
+  },
+  bulkGenerationRateLimit: "1/1h"
+}),
+```
+
+## Rate Limiting and Best Practices
+
+- Use `rateLimit` for individual image generation operations
+- Set `bulkGenerationRateLimit` to prevent API quota exhaustion
+- Consider using lower resolution (`512x512`) for faster generation and lower costs
+- Test prompts thoroughly before applying to large datasets