TypeScript SDK

npm install @agentix/sdk

pnpm add @agentix/sdk

yarn add @agentix/sdk

import { AgentixClient } from '@agentix/sdk'
 
const client = new AgentixClient({
  apiKey: process.env.AGENTIX_API_KEY,
  // Optional: custom base URL
  // baseUrl: 'https://app.agentix.cl',
})
 
// Send a message
const response = await client.chat('agent_abc123', {
  message: 'Hello, what can you help me with?',
  sessionId: 'session-001',
})
 
console.log(response.message)

const client = new AgentixClient({
  // Required: your API key
  apiKey: 'agx_live_YOUR_KEY',
 
  // Optional: API base URL (defaults to https://app.agentix.cl)
  baseUrl: 'https://app.agentix.cl',
 
  // Optional: request timeout in milliseconds (default: 30000)
  timeout: 30000,
 
  // Optional: custom fetch implementation
  fetch: customFetch,
})

const response = await client.chat('agent_id', {
  message: 'What products do you have?',
  sessionId: 'session-001',
  visitorEmail: 'user@example.com',
  visitorName: 'John',
  metadata: { source: 'mobile-app' },
})
 
// Response
console.log(response.message)         // Agent's text response
console.log(response.conversationId)  // Conversation ID
console.log(response.messageId)       // Message ID
console.log(response.uiSpec)          // Rich UI spec (if any)

const stream = client.chatStream('agent_id', {
  message: 'Tell me a story',
  sessionId: 'session-001',
})
 
for await (const chunk of stream) {
  process.stdout.write(chunk.text)
}

const response = await client.teamChat('team_id', {
  message: 'I need billing help',
  sessionId: 'session-001',
})
 
console.log(response.message)
console.log(response.agentId)       // Which agent handled it
console.log(response.agentName)     // Agent's display name
console.log(response.routingReason) // Why this agent was chosen

const agent = await client.getAgent('agent_id')
 
console.log(agent.name)
console.log(agent.description)
console.log(agent.theme.primaryColor)
console.log(agent.features.enableRating)

const widgetConfig = await client.getWidgetConfig('agent_id')
 
console.log(widgetConfig.widget.position)
console.log(widgetConfig.widget.autoOpen)
console.log(widgetConfig.theme)

const conversation = await client.getConversation('agent_id', 'session-001', {
  limit: 20,
  offset: 0,
})
 
for (const msg of conversation.messages) {
  console.log(`${msg.role}: ${msg.content}`)
}

await client.updateConversation('agent_id', 'session-001', {
  rating: 5,
  feedback: 'Very helpful!',
  visitorEmail: 'user@example.com',
})

import { AgentixClient, AgentixError } from '@agentix/sdk'
 
try {
  await client.chat('agent_id', {
    message: 'Hello',
    sessionId: 'session-001',
  })
} catch (error) {
  if (error instanceof AgentixError) {
    console.error(`API Error: ${error.code}`)   // e.g., 'AGENT_NOT_FOUND'
    console.error(`Status: ${error.status}`)      // e.g., 404
    console.error(`Message: ${error.message}`)    // Human-readable message
  } else {
    // Network or other error
    console.error('Unexpected error:', error)
  }
}

import type {
  AgentixClientOptions,
  ChatRequest,
  ChatResponse,
  StreamChatResponse,
  AgentConfig,
  WidgetConfig,
  ConversationResponse,
  ConversationMessage,
  ConversationUpdateRequest,
} from '@agentix/sdk'

// Next.js API Route
import { AgentixClient } from '@agentix/sdk'
 
const client = new AgentixClient({
  apiKey: process.env.AGENTIX_API_KEY!,
})
 
export async function POST(request: Request) {
  const { message, sessionId } = await request.json()
 
  const response = await client.chat('agent_id', {
    message,
    sessionId,
  })
 
  return Response.json(response)
}