diff --git a/docs/ai_agents.md b/docs/ai_agents.md index 321baf6..c92d3df 100644 --- a/docs/ai_agents.md +++ b/docs/ai_agents.md @@ -21,8 +21,45 @@ The Master Key is designed to be connected directly to the text or prompt input image + + + +## 🤖 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. + + image - + Gemini API: The foundational engine that connects your workflows to Google's AI.