For integrations with other AI platforms, see the Artificial Intelligence article in the User Guide.
Drafts provides scripting wrappers to simplify interaction with Anthropic’s Claude AI through its Claude API.
This article covers the setup required to use such actions, which integrate with Claude, and provides useful examples of actions for common use cases, like text manipulation and prompts.
Setting Up Claude API Access
In order to use any of these integrations, you will need a Anthropic account and an API key to use with Drafts.
The Anthropic API requires you configure your account and billing information. Information on costs at the Anthropic side. Generally speaking, occasional usage in Drafts will not be costly, and it is billed per usage and not based on any monthly fees.
To get an API key, visit the Anthropic Dashboard. Use the “Get API key” link, and copy the API key generated for use in Drafts. You will be prompted to enter the key the first time you use one of the example actions below.
Drafts will remember the API key in its Credentials system, so you will only need to complete this step once. If you need to change the API key used, you can forget it in the Credentials pane in Drafts settings, and the next time you use a Claude action, you will be prompted to enter a new key.
Example Actions
Below are a few example use-case actions that are meant as a starting point to demonstrate some ways Google Gemini integration can be used in Drafts:
- Ask Claude: This action will ask you to enter a text prompt for Gemini and insert the result in the current draft.
- Claude: Converse: Mimics a chat bot interface, so allow an on-going conversation with Claude.
- Claude: Translate Selection: Take the selected text in the editor, and ask Claude to translate it into another language. You will be prompted to select from a list of languages.
- Claude: Modify Selection: Select text in a draft, then run this action, and you will be prompted for an instruction to transform the text. Drafts will package that up in a prompt and replace the selected text with the result. You can do simple things like “uppercase” but also combine commands for things like “uppercase and insert a
emoji between each word.”
Scripting with AnthropicAI
If you wish to build your own more advanced integrations, the AnthropicAI script object is your starting point.
This object provides a convenience wrapper for making API calls to the Anthropic AI API. When making requests with this object, Drafts will take care of requesting and storing a user’s API key, providing the appropriate authentication headers, and parsing results into Javascript objects.
The object provides several additional simple request functions, like quickPrompt that abstract details about the API for simple use cases, but also the request function to build more detailed requests with all the API options. Refer to Anthropic’s API documentation on request parameters and return values.
The below action is meant as a starting point and demonstrates the use of the request function. Get more examples in the scripting reference:
Troubleshooting
If you run into issues running these actions, be sure to check the Action Log for detailed error messages. Common problems include rate limits or improperly configured API keys.
Conclusion
If you create new and interesting actions with this functionality, we hope you’ll share them in the directory and forums!
