Skip to main content

Overview

CaesuraO analyzes dialogue and gives your AI agent guidance about how to respond. Your model still generates the reply; CaesuraO adds context about communication patterns, emotional shifts, and possible next steps.

Choose an integration​

  • SDKs: Use these when building your own application. The SDK wraps your model client, sends dialogue for analysis, and adds guidance to the model's prompt.
  • MCP: Use this with an existing MCP-compatible client, such as Cursor or Claude Desktop. The client calls CaesuraO tools when it needs analysis.

How the SDK works​

  1. Your application sends conversation history to the wrapped model client.
  2. The SDK sends dialogue text to CaesuraO for analysis.
  3. CaesuraO returns guidance, which the SDK keeps for that conversation.
  4. The SDK adds available guidance to a model request, and your model generates the reply.

Your application keeps its normal dialogue history. The SDK manages the added guidance separately.

Choose when analysis runs​

Async mode (default) runs analysis in the background while the model responds. Completed guidance is available to a later call. This works well when low latency matters.

Sync mode waits for analysis before calling the model, so guidance can affect the current reply. Use it when immediate guidance matters more than response latency, or for short scripts that need analysis to finish before exiting.

Set mode: 'sync' in JavaScript or mode="sync" in Python. This setting is separate from using Python's sync or async OpenAI client.

Conversations​

The SDKs save analyses by default. Create a CaesuraO conversation once and reuse its ID, or enable automatic creation for your application's local chat IDs. Continue supplying dialogue history on each call. See Conversations & Persistence.

Where data goes​

  • Your provider API key goes only to the model provider.
  • Your CaesuraO API key goes only to CaesuraO.
  • Dialogue text goes to both services for generation and analysis. System instructions and tool results are excluded from CaesuraO's analysis transcript.

Keep both API keys on your server. Start with the Quickstart to make your first call.