Anthropic

discover how to connect engini with anthropic and use its activities to manage files, create message batches, and generate ai powered responses with claude models getting started with anthropic prerequisites an anthropic account you can create an account at https //claude ai/login?from=logout retrieve your anthropic api key create an anthropic account complete the sign in process and get your account log in to anthropic once you have an account, log in to the anthropic platform navigate to the api key section after logging in go to the api keys section which is typically in the center of the page next to generate a prompt and create a prompt generate an api key once you click to get api key, a key will be generated copy the api key make sure to store it securely, as it provides access to your anthropic resources in engini connecting engini to anthropic enter your engini account at https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking https //app engini io/connections click on the add connection option located at the topbar choose claude option from the available applications 5\ enter the following details in the “edit connection” form connection name – enter a meaningful name for your connection api key – when you create an anthropic account, you’ll receive an api key copy it and paste it into this field save click on the save button to save your connection actions create a file upload a new file to your anthropic account content enter the content for the new file, encoded in base64 create a message batch submits multiple messages at once to anthropic’s api for processing click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use here to build it for the create a message batch activity, you must follow these steps use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o5qm90hhwykusy9lvkxoa#fognd twice first create the inner message array variable messages, object element type messages type – the common types are image, document and text note if you choose image or document , don’t forget to fill in source data , source type , and media type second create the outer requests array variable requests, object element type requests fields can be filled by clicking add field , and https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o5qm90hhwykusy9lvkxoa#zo8hn can be used to add additional objects final step in the create a message batch activity, set the requests\[] field to the dynamic variable from step 1 (e g , requests\[]) field s – requests\[] this is an array containing all the individual message requests you want to include in the batch create messages send a structured list of messages to anthropic claude api and receives ai generated responses messages \[] enter the messages array each message must include a role (user or assistant) and a content array for claude, each item in the content array must be an object that includes type and its corresponding fields to build it for the create messages activity, you must follow these steps use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o5qm90hhwykusy9lvkxoa#fognd twice first create the inner content array variable content, object element type content type – the common types are image, document and text note if you choose image or document , don’t forget to fill in source data , source type , and media type second create the outer messages array variable messages, object element type messages fields can be filled by clicking add field , and https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o5qm90hhwykusy9lvkxoa#zo8hn can be used to add additional objects final step in the create messages activity, set the messages field to the dynamic variable from step 1 (e g , messages\[]) model select the anthropic claude model you want to use (e g , claude 3 sonnet 20240229, claude 3 opus 20240229) max tokens set the maximum number of tokens claude can generate in the response add field by clicking the “add field” button, you can choose how to fill in the various fields in the messages you are creating you can add one field to the activity or more fields to the activity definitions, up to the number of fields you have in the selected object the fields vary depending on the selected object click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate example the system field for example is an optional field that acts as a super prompt that the claude model reads and internalizes before it processes the user’s messages initialize object creates a new variable object in your workflow to store structured data for use in subsequent claude steps for example, a message\[] object can be initialized here and used in other actions, such as creating messages 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 with data in later workflow steps append to object array adds new data elements to an existing array of objects in your workflow select 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 type after adding a variable to the action, any mandatory fields will appear (if there are any) in this example, the selected variable shows a ‘type’ field below the variable selection add field by clicking the “add field” button, you can choose how to fill in the various fields in the object you are creating you can add one field to the activity or more fields to the activity definitions, up to the number of fields you have in the selected object the fields vary depending on the selected object choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate 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 by clicking the “add field” button, you can choose how to fill in the various fields when you are mapping choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate delete a message batch cancels and removes a previously submitted batch of messages from anthropic’s processing queue message batch id enter the unique identifier of the message batch you want to delete this id was provided when you originally created the batch request to anthropic’s api delete file this action permanently deletes the file and cannot be undone ensure you have the correct file id before executing this action file id enter the unique identifier of the file you want to delete this id was provided when the file was originally created or uploaded to the system download file download the contents of a claude generated file file id enter the unique identifier of the file you want to download this id was provided when the file was originally created or uploaded to the system cancel a message batch stops the processing of a submitted message batch that is currently in queue or being processed by anthropic’s api message batch id enter the unique identifier of the message batch you want to cancel this id was provided when you originally created the batch request to anthropic’s api get file metadata retrieves information about a file without downloading its actual content, such as file size, creation date, file type, and other properties file id enter the unique identifier of the file you want to download this id was provided when the file was originally created or uploaded to the system retrieve a message batch fetches detailed information about a specific message batch, including its current processing status and metadata message batch id enter the unique identifier of the message batch you want to retrieve information for this id was provided when you originally created the batch request retrieve message batch results fetch the results of a previously submitted message batch message batch id enter the unique identifier of the message batch you want to retrieve information for this id was provided when you originally created the batch request count message tokens calculates the total number of tokens that will be consumed by your messages before sending them to anthropic’s api, helping you estimate costs and manage usage messages\[ ] select the array of messages you want to count tokens for each message should contain the text content you plan to send to claude model choose the specific anthropic model (e g , claude sonnet, claude opus) you intend to use add field by clicking the “add field” button, you can add additional parameters to customize how token counting is performed or to include metadata with your token count request you can add one field to the activity or more fields to the activity definitions, up to the number of fields in the object choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate list files retrieves your list of files with options to filter and limit the results top n you can specify how many files you want to retrieve by clicking on ‘top n’ and entering the maximum number of files you want to return if you set top n = 1 , a single file will be returned instead of an array if no file is found when using top n = 1 , the action will fail, allowing you to implement an if condition within the workflow this functionality is useful for processes where the existence of a specific file determines the next steps in the workflow add filters you can specify which files will be returned from the search results by utilizing the “add filter” button choose from the drop down the field you want to filter by select the condition you want the records to meet for the selected field click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate list message batches retrieves a list of all message batches that have been created in your anthropic account, showing their details