Clear Transcript Action

This action resets the current chatbot transcript. The chatbot transcript represents the message flow between the end-user and the chatbot. You can access the transcript in textual format using the flow’s transcript attribute.

Accessing the Transcript

For example, you can use the transcript attribute in your flows:

Primary Use Case: ChatGPT Integration

It’s very useful to reset your transcript during a flow for several reasons. One of the main reasons is when you need to restart a conversation with a ChatGPT Task (or Ask the Knowledge Base) that has the “Use chat History in the Prompt” option active:

Using this action, you can restart a conversation while moving through the flow, restarting your prompt so the old conversation history does not interfere with the new one.

Benefits of Clearing Transcripts

Fresh Context

Start new conversation topics without the influence of previous interactions.

Improved AI Performance

Prevent AI models from getting confused by irrelevant historical context.

Memory Management

Avoid token limits when working with lengthy conversation histories.

Topic Switching

Enable clean transitions between different conversation topics or purposes.

Privacy Control

Clear sensitive information from conversation memory when needed.

When to Use Clear Transcript

Starting New Topics

When transitioning to completely different conversation subjects.

After Issue Resolution

Clear the transcript after successfully resolving a customer issue to start fresh for new inquiries.

Department Changes

When transferring between different departments or support types.

Context Reset for AI

Before engaging specialized AI tasks that require clean context.

Privacy Compliance

When users request to clear their conversation history.

Common Implementation Patterns

Topic Transition Flow

User completes Topic A → Clear Transcript → Begin Topic B with fresh context

Multi-Stage Support

Basic Support → Issue Resolved → Clear Transcript → Advanced Support Available

Department Handoff

Sales Conversation → Complete → Clear Transcript → Technical Support Begins

AI Context Management

General Chat → Clear Transcript → Specialized AI Task (e.g., technical analysis)

Best Practices

1. Strategic Timing

Clear transcripts at natural conversation breaks, not mid-conversation.

2. User Communication

Inform users when starting fresh topics or switching contexts.

3. Preserve Important Data

Save critical information to attributes before clearing transcript if needed later.

4. AI Optimization

Use before AI tasks that need clean context for optimal performance.

5. Privacy Considerations

Respect user privacy by clearing transcripts when requested.

Integration with Other Actions

ChatGPT Tasks

Clear transcript before ChatGPT tasks to ensure clean context:

Clear Transcript → ChatGPT Task → Process Response

Condition Actions

Use conditions to determine when transcript clearing is needed:

If topic_change = true → Clear Transcript
If conversation_length > threshold → Clear Transcript

Department Changes

Clear transcript when switching between departments:

Change Department → Clear Transcript → New Department Context

Knowledge Base Queries

Reset before specialized knowledge base searches:

Clear Transcript → Ask Knowledge Base → Provide Focused Results

Technical Considerations

Attribute Preservation

The Clear Transcript action only clears the conversation history, not user attributes or session data.

AI Model Behavior

Different AI models handle context differently. Test to ensure optimal performance.

Token Management

Clearing transcripts helps manage token usage in AI API calls.

Performance Impact

Regular transcript clearing can improve chatbot response times and accuracy.

Advanced Use Cases

Multi-Session Management

For returning users, clear transcript to start fresh while preserving user profile data.

Specialized AI Workflows

Clear transcript before engaging domain-specific AI models that need clean context.

Compliance Requirements

Implement transcript clearing for regulatory compliance in sensitive industries.

A/B Testing

Use transcript clearing to test different conversation flows with clean states.

Monitoring and Analytics

Tracking Transcript Clears

Monitor when and why transcripts are being cleared to optimize conversation flows.

Performance Metrics

Measure AI performance improvements after implementing strategic transcript clearing.

User Satisfaction

Track user satisfaction in conversations that use transcript clearing effectively.

Troubleshooting Common Issues

Lost Context

If users seem confused after transcript clearing, provide better transition messaging.

AI Confusion

If AI responses degrade after clearing, review your prompting strategy.

Workflow Disruption

Ensure transcript clearing doesn’t interrupt natural conversation flow.

The Clear Transcript action is a powerful tool for managing conversation context in Pingstreams, particularly when working with AI integrations that benefit from clean, focused context windows.

For more advanced transcript management strategies or specific AI integration questions, contact our support team or explore our comprehensive Pingstreams documentation.

Happy chatbot building with Pingstreams!