Prerequisites
Install the Tracia SDK, the Vercel AI SDK, and the provider package(s) you need:npm install tracia ai @ai-sdk/openai
npm install tracia ai @ai-sdk/anthropic
npm install tracia ai @ai-sdk/google
npm install tracia ai @ai-sdk/amazon-bedrock
npm install tracia ai @ai-sdk/openai @ai-sdk/anthropic @ai-sdk/google @ai-sdk/amazon-bedrock
.env
TRACIA_API_KEY=tr_your_tracia_key
OPENAI_API_KEY=sk-your-openai-key
ANTHROPIC_API_KEY=sk-ant-your-anthropic-key
GOOGLE_API_KEY=your_google_key
# For Amazon Bedrock
AWS_ACCESS_KEY_ID=your-access-key-id
AWS_SECRET_ACCESS_KEY=your-secret-access-key
AWS_REGION=us-east-1
OpenAI
import { Tracia } from 'tracia';
const tracia = new Tracia({ apiKey: process.env.TRACIA_API_KEY });
const result = await tracia.runLocal({
model: 'gpt-4o',
messages: [
{ role: 'system', content: 'You are a helpful coding assistant.' },
{ role: 'user', content: 'Write a function to reverse a string in TypeScript.' }
],
temperature: 0.7,
maxOutputTokens: 500
});
console.log(result.text);
console.log(`Tokens used: ${result.usage.totalTokens}`);
Anthropic
import { Tracia } from 'tracia';
const tracia = new Tracia({ apiKey: process.env.TRACIA_API_KEY });
const result = await tracia.runLocal({
model: 'claude-sonnet-4-20250514',
messages: [
{ role: 'system', content: 'You are a creative writing assistant.' },
{ role: 'user', content: 'Write a short story opening about a time traveler.' }
],
temperature: 0.9,
maxOutputTokens: 1000
});
console.log(result.text);
console.log(`Provider: ${result.provider}`);
import { Tracia } from 'tracia';
const tracia = new Tracia({ apiKey: process.env.TRACIA_API_KEY });
const result = await tracia.runLocal({
model: 'gemini-2.0-flash',
messages: [
{ role: 'user', content: 'Explain the difference between HTTP and HTTPS.' }
],
temperature: 0.5
});
console.log(result.text);
console.log(`Latency: ${result.latencyMs}ms`);
Multi-Turn Conversations
Include previous messages to maintain conversation context:const result = await tracia.runLocal({
model: 'gpt-4o',
messages: [
{ role: 'system', content: 'You are a math tutor.' },
{ role: 'user', content: 'What is 15% of 80?' },
{ role: 'assistant', content: '15% of 80 is 12.' },
{ role: 'user', content: 'How did you calculate that?' }
]
});
With Tracing Metadata
Add tags and user identifiers for filtering in the Tracia dashboard:const result = await tracia.runLocal({
model: 'gpt-4o',
messages: [
{ role: 'user', content: 'Summarize the key points of agile development.' }
],
tags: ['production', 'summarization'],
userId: 'user_abc123',
sessionId: 'session_xyz789'
});
console.log(`Span ID: ${result.spanId}`);
// View this span in the Tracia dashboard
Streaming
Enable streaming to receive responses in real-time:const stream = tracia.runLocal({
model: 'gpt-4o',
messages: [
{ role: 'user', content: 'Write a short poem about coding.' }
],
stream: true,
});
// Span ID is available immediately
console.log(`Span: ${stream.spanId}`);
// Iterate to receive chunks
for await (const chunk of stream) {
process.stdout.write(chunk);
}
// Get final result with usage stats
const result = await stream.result;
console.log(`\nTokens: ${result.usage.totalTokens}`);
Without Tracing
Disable tracing when you don’t need observability:const result = await tracia.runLocal({
model: 'gpt-4o-mini',
messages: [
{ role: 'user', content: 'What is 2 + 2?' }
],
sendTrace: false
});
console.log(result.spanId); // Empty string