Gemini

discover how to connect engini to the powerful google gemini api getting started with gemini prerequisites a google account / google ai studio access an active api key retrieve your gemini api key create a google ai account navigate to the google ai studio website https //ai google dev/gemini api/docs/api key or the google cloud console log in to google ai studio once you have an account, log in to the google ai studio platform navigate to the api key section after logging in, go to the api keys section in your google ai studio dashboard generate a new api key click on the create api key button once you click, a new key will be generated this is your access token create a new key name your key as you wish press the “create key” when you are done copy the key copy the api key immediately you will not be able to view the full key again for security reasons make sure to store it securely, as it provides access to your gemini resources connecting engini to gemini enter your engini account at https //app engini io https //app engini io/ navigate to the connections page by clicking on connections in the left sidebar or by clicking here https //app engini io/connections click on the "new integration" option located at the top bar choose the gemini option from the available applications enter the following details in the “new integration” form and press save connection name enter a unique and descriptive name for this connection this name will help you easily identify and manage the gemini connection within your engini account api key – enter the api key you obtained from google gemini save settings click on the save button to save your connection actions create a completion send a prompt (text, image or document) to a gemini model and receive an ai generated response model select the gemini model you want to use (e g , gemini 2 5 flash, gemini 2 5 pro) contents enter the input or conversation history for the model for a single turn request, this is the main prompt text for multi turn conversations, this field contains the array of previous user/model messages to build it for the create a completion activity, you must initialize and append objects in three steps use initialize object array twice create the inner parts with its fields variable parts, type parts create the outer contents with its fields variable contents, type contents use add field or the append to object array activity to construct the necessary json objects and arrays, which is the fundamental step required before passing the final, structured data to the create a completion activity use append to object array to add object fields final step in the create a completion activity, set the contents field to the dynamic array variable from step 2 add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields initialize object array creates a new variable object in your workflow to store structured data for use in subsequent gemini steps for example, a contents object can be initialized here and used in other actions, such as create a completion variable name enter a name for the new object variable you’re creating this name will be used to reference this object in other workflow steps object element type select the type of data structure you want to initialize from the dropdown options this action prepares an empty object of the specified type that you can then populate the first object here and then later in the append action add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields append to object array adds new data elements to an existing array of objects in your workflow variable select the array variable from your workflow that you want to append new objects to this dropdown shows all available array variables that you initialized from previous steps in your automation add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields map object array this activity is particularly useful when there is an array of data that needs to be translated into another structure data list choose a data list that you’ve obtained from previous activities in your workflow this data list typically contains an array of objects that you want to process and transform object name you need to define the type of objects from the drop down that will be stored within the array add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields delete a file this action allows you to delete a file from gemini’s system file name the name must follow the format files/{file} (e g , files/abc 123) this unique format is how the service internally identifies and locates the specific file to be deleted note the name field can be selected dynamically from the get files activity output when more than one file is returned, apply the first() function to retrieve the name of the first file extract structure data this activity uses the advanced capabilities of the gemini model to analyze unstructured or semi structured input (such as text, emails, or images) and extract meaningful information, returning the results in a structured json format model selects the specific gemini model (e g , gemini pro) that will perform the extraction different models have varying capabilities in handling text, images, and complexity response schema this is where you insert a json structure that defines exactly how the final output must look the gemini model will use this blueprint to organize the data it extracts, ensuring you get a predictable, standardized json object every time (e g , specifying fields like "name," "amount," and "date") properties defines all the keys (fields) and their data types for the output json object used once at the top level of the schema, but can contain multiple field definitions (keys) inside it description the model's instruction tells the gemini model precisely what value to extract for a specific field (e g , "the customer's full name, extracted from the first sentence ") highly recommended for accurate extraction; acts as a prompt for that specific field required the constraint an array listing the field names that must be present in the final json object guarantees the key will be present if data is missing, the model will try to infer a value or use a null/default value to satisfy this constraint add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields get files this action allows you to retrieve the list of files stored in your gemini’s account send api request this activity allows you to send a custom api request directly to the outlook api base url – this is the root url of the api you’re sending the request to relative url – you can specify additional path segments or parameters that need to be added to the end of the automatically generated url this allows you to customize the specific request you want to perform method – select the http method (e g , get, post, put, delete, patch) body type – defines the format of the data in the body of your request commonly used values include application/json (as shown), which means the body will contain a json formatted payload body – contains any data that is being sent to the server add headers – additional metadata about the request, such as the type of data the engini can accept, the length of the request body, and authentication information add queries – the query refers to the parameters or data that are included in the url of an http request to provide additional information or instructions to the server upload a file upload a new file to your gemini account the file can be a pdf, image or even a video content this is where you upload the file in a form of base64 paste the base64 encoded content of the file you want to upload this represents the full file data in text format display name choose a unique name for the file uploaded