ToneClone icon

ToneClone

Write with AI in your voice and style - Generate writing that sounds like you, not a robot

Actions3

Overview

This node integrates with the ToneClone AI service to generate written content that mimics a specific persona's voice and style. It is particularly useful for creating personalized emails, marketing copy, or any text that should reflect a consistent tone aligned with a chosen persona. Users can provide a prompt and select a ToneClone persona to produce writing that sounds natural and tailored rather than robotic.

A practical example: generating a professional follow-up email after a meeting using a selected persona that reflects your personal or brand voice, optionally enhanced with additional context from knowledge cards.

Properties

Name Meaning
Persona Name or ID Select the ToneClone persona to use for writing. Options are loaded dynamically from your ToneClone account, including built-in personas. You can also specify an ID via expression.
Prompt The instruction or prompt describing what you want the AI to write. For example, "Write a professional email to follow up on our meeting...".
Knowledge Card Names or IDs Optional selection of one or more knowledge cards to provide additional context for the writing. These are loaded dynamically from your ToneClone knowledge cards and can be specified by name or ID.
Additional Options A collection of optional parameters:
- Context: Extra textual context to guide the writing (e.g., "We discussed quarterly goals and budget allocation...").
Other options like formality, reading level, length may also be supported but are not shown in the provided properties JSON.

Output

The node outputs JSON data containing the generated text and metadata about the request:

  • content: The generated text content as a string.
  • personaId: The ID of the persona used for generation.
  • prompt: The original prompt provided.
  • knowledgeCardIds: Array of knowledge card IDs used (empty if a built-in persona was used).
  • isBuiltInPersona: Boolean indicating if the persona is built-in.
  • Additional fields from the "Additional Options" input may be echoed back.
  • done (optional): Boolean indicating if the generation process is complete.

No binary output is produced by this operation.

Example output JSON snippet:

{
  "content": "Dear John,\n\nThank you for meeting with me last week...",
  "personaId": "abc123",
  "prompt": "Write a professional email to follow up on our meeting...",
  "knowledgeCardIds": ["kc1", "kc2"],
  "isBuiltInPersona": false,
  "context": "We discussed quarterly goals and budget allocation...",
  "done": true
}

Dependencies

  • Requires an API key credential for the ToneClone API.
  • The node uses the ToneClone API base URL configured in credentials.
  • Dynamic loading of personas and knowledge cards depends on valid API credentials and existing resources in the ToneClone account.
  • The node sends HTTP requests authenticated with the provided API key.

Troubleshooting

  • No personas found error: If no personas are returned, ensure you have created personas in your ToneClone account and that your API credentials are correct.
  • API key issues: Errors related to missing or invalid API keys will prevent loading personas or knowledge cards. Verify your API key and URL configuration.
  • No binary data found: This applies to other operations (not the Write with Your Persona operation) when uploading files; ensure the binary property name matches the input data.
  • Unsupported operation error: Occurs if an unsupported resource-operation combination is selected.
  • Network or authentication errors: Check network connectivity and API key validity.
  • When errors occur during execution, if "Continue On Fail" is enabled, the node returns error details per item instead of stopping.

Links and References

Discussion