Make AI Agents app

t he make ai agents app, in the {{scenario singular}} builder, allows you to use ai agents in {{scenario plural lowercase}} this article outlines the app's modules and their credit usage modules run an agent the make ai agents > run an agent module allows you to create ai agents, provide agents with tools, and send messages to agents — either as additional instructions or tasks agent choose an existing agent or click the create agent button to create a new agent in the connection field, select your connection in the agent name field, fill in your agent's identification in the model field, select the language model and version provided by your ai service provider in the system prompt field, define the agent's purpose and constraints the system prompt defines the agent in all the {{scenario plural lowercase}} it uses in each {{scenario singular lowercase}} , you can further customize the agent's description with additional instructions context in context , you can view the context files the agent uses for reference thread id in thread id , you can specify a custom thread id to keep all of your interactions with the agent in the same communication thread if you leave the thread id field empty, a new thread id appears in the output additional system instructions in additional system instructions , you can share extra contextual information with the agent dynamically provide context by mapping data from the {{scenario singular lowercase}} to this field messages in messages , send tasks and specific requirements to the agent you can send multiple user messages at once timeout in timeout , set the maximum number of seconds the agent can execute until it is terminated if you leave the timeout field empty, the timeout is 300 seconds (5 minutes) the maximum timeout is 600 seconds (10 minutes) create agent context (file) the make ai agents > create agent context (file) module allows you to upload a context file to an ai agent it is similar to the context field in the ai agents configuration tab, but enables files to be dynamic for example, if you make changes to a google drive document, running this module gives the agent access to the latest version to use create agent context (file) in a {{scenario singular lowercase}} in scenario builder, add a module that retrieves the context file, for example, a google drive > download a file module add the create agent context(file) module in the create agent context(file) module's configuration, under agent , select an existing agent that will store the file as context alternatively, create a new agent in file , select the preceding module that retrieved the file, or map specific data from the file in map click save click run once you have now uploaded a context file to your ai agent you can check the file in the ai agents configuration tab, in context if you try to run this module again to upload an updated context file, you'll receive an error message to prevent an error, add a delete specific agent context module between the module that downloads the file and the create agent context module select the file to delete and replace agent select an existing agent that will store the context file, or click the create agent button to create a new agent tools tools that your selected agent can use scenarios scenarios your selected agent can use in add tools , you can add new scenarios context upload context files that your selected agent uses as a reference you can also see the files you already uploaded to the agent file choose the name of the module that downloaded the context file this option uploads the entire file and keeps the same file name as the original map change the file name in file name and map a specific value from the context file in data create agent context (text) the make ai agents > create agent context(text) module allows you to upload text to an ai agent to be used as its context agent select an existing agent that will store the context file, or click the create agent button to create a new agent context name name the context file to identify and retrieve it later context insert text or map text from preceding modules get agent contexts the make ai agents > get agent contexts module retrieves the context files that an ai agent has stored in its memory when you run the module, context files appear in the module's output to view its output, click on the white bubble above the module under operation , expand body , which includes a numbered item for each context file agent select an existing agent, or click the create agent button to create a new agent delete specific agent context the make ai agents > delete specific agent context module allows you to delete an ai agent's context file you can use this module to remove a specific context file from an agent's memory, or delete a file to replace it with an updated version agent select an existing agent, or click the create agent button to create a new agent context select an uploaded context file to delete from an agent's memory delete all agent context the make ai agents > delete specific agent context module allows you to delete all context files stored in an ai agent's memory you can use this module on its own in a scenario click run once to delete all of the agent's context files agent select an existing agent, or click the create agent button to create a new agent credit usage the make ai agent app uses credits docid\ sqbfn9s1f2nbq71kqhq7x differently depending on the module and whether you use credits docid\ hh nrtakeqakbmg63uuin or your own connection (e g , via an api key) to an ai provider the table below outlines make ai agent modules and their credit usage logic module uses make's ai provider uses your connection (pro+) run an agent 1 credit per operation + credits based on ai token usage 1 credit per operation create agent context (file) 1 credit per operation + credits based on token usage, including ai tokens (file description generation) embedding tokens (vectorization) 1 credit per operation + embedding tokens (vectorization) create agent context (text) 1 credit per operation + credits based on token usage, including ai tokens (file description generation) embedding tokens (vectorization) 1 credit per operation + embedding tokens (vectorization) get agent contexts 1 credit per operation 1 credit per operation delete specific agent context 1 credit per operation 1 credit per operation delete all agent context 1 credit per operation 1 credit per operation note the following specifics about create agent context modules embedding tokens are used when {{product name}} converts chunks of a context file into numbers (vectors) to be stored in make's rag database, turning the file into a retrievable format for ai agents the number of embedding tokens will depend on file size ai tokens for file description generation are used when an ai provider summarizes a context file based on the first part of the file when you use make's ai provider, make bills you for these ai tokens if you use your own provider, they will bill you for the tokens when you trigger an agent in a scenario through testing & training in the ai agents configuration tab, this action uses 1 credit for each chat input, in addition to each operation (and tokens, when relevant) used