Update ai_agents.md

docs/ai_agents.md

@@ -21,8 +21,45 @@ The Master Key is designed to be connected directly to the text or prompt input
 
 <img width="1287" height="420" alt="image" src="https://github.com/user-attachments/assets/8593631b-591f-42fb-8439-110d44bea4d8" />
 
+ 
+
+
+## 🤖 Gemini API
+The core engine that connects your workflow to Google's powerful Gemini family of models, allowing for advanced text and image analysis and generation.
+
+Philosophy & Use Case
+This node is the foundational "brain" for all AI-powered tasks in the Creepybits suite. It takes a complete creative brief—typically from a node like Master Key or Director's Slate—and sends it along with a set of fine-tuning parameters to the Gemini model for processing. The model then "thinks" about the request and sends back a newly generated, enhanced, or analyzed text.
+
+You will almost always use this node as the second step in a prompt-generation workflow, right after a node that prepares your initial idea. It is the essential component that brings the AI's intelligence into your creative process.
+
+Inputs & Parameters
+image (IMAGE, optional): An input image for the AI to analyze, allowing for powerful multimodal workflows (e.g., describing a picture or using it as inspiration).
+
+system_prompt (STRING): This is the primary mission briefing for the AI. It should contain the user's core idea and any guiding instructions, typically piped in from the text output of a Master Key node.
+
+Model Parameters (model, temperature, top_p, etc.): These sliders and dropdowns are the fine-tuning controls for the AI's "personality." They allow you to control everything from its creativity (temperature) to the length of its response (max_output_tokens).
+
+API Key Path: A widget to specify the file path to your gemini_api_key.txt file. This tells the node how to securely authenticate with Google's services.
+
+Note: The user_instructions text box is a legacy field and is not used in current workflows. It can be safely ignored.
+
+Outputs
+text (STRING): The final text generated by the Gemini model, ready to be used as a prompt for a text-to-image model or for any other purpose in your workflow.
+
+Example Workflow
+The Gemini API node acts as the bridge between your initial idea and the final, AI-generated prompt. Here is its most common use case:
+
+The user types a simple idea into the Master Key node.
+
+The Master Key sends that idea to the system_prompt input of the Gemini API node.
+
+The Gemini API node sends the idea to the external AI for processing.
+
+The AI generates a rich, detailed prompt and sends it back to the Gemini API node's text output.
+
+
 <img width="1484" height="534" alt="image" src="https://github.com/user-attachments/assets/f5c9b8d5-ca2a-45ad-bc95-21050c6c8b24" />
-  
+
 
 
 Gemini API: The foundational engine that connects your workflows to Google's AI.