Agents API

{
  "id": "agent_1a2b3c4d5e",
  "name": "Customer Support Bot",
  "model": "gpt-4o",
  "system_prompt": "You are a helpful customer support agent for Acme Corp.",
  "temperature": 0.5,
  "max_tokens": 1024,
  "status": "active",
  "created_at": "2025-03-10T08:00:00Z",
  "updated_at": "2025-03-12T14:30:00Z"
}

curl -X POST https://api.chatsby.co/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Assistant",
    "model": "gpt-4o",
    "system_prompt": "You are a knowledgeable sales assistant for Acme Corp. Help customers understand our products and pricing. Be friendly and professional.",
    "temperature": 0.6,
    "max_tokens": 1024
  }'

const response = await fetch('https://api.chatsby.co/v1/agents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Sales Assistant',
    model: 'gpt-4o',
    system_prompt: 'You are a knowledgeable sales assistant for Acme Corp.',
    temperature: 0.6,
    max_tokens: 1024,
  }),
});
 
const agent = await response.json();
console.log(agent.id); // "agent_f7g8h9i0j1"

{
  "id": "agent_f7g8h9i0j1",
  "name": "Sales Assistant",
  "model": "gpt-4o",
  "system_prompt": "You are a knowledgeable sales assistant for Acme Corp. Help customers understand our products and pricing. Be friendly and professional.",
  "temperature": 0.6,
  "max_tokens": 1024,
  "status": "active",
  "created_at": "2025-03-15T10:00:00Z",
  "updated_at": "2025-03-15T10:00:00Z"
}

curl "https://api.chatsby.co/v1/agents?page_size=10&status=active" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.chatsby.co/v1/agents?page_size=10&status=active',
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
  }
);
 
const { data, has_more, next_cursor } = await response.json();

{
  "data": [
    {
      "id": "agent_f7g8h9i0j1",
      "name": "Sales Assistant",
      "model": "gpt-4o",
      "system_prompt": "You are a knowledgeable sales assistant...",
      "temperature": 0.6,
      "max_tokens": 1024,
      "status": "active",
      "created_at": "2025-03-15T10:00:00Z",
      "updated_at": "2025-03-15T10:00:00Z"
    },
    {
      "id": "agent_1a2b3c4d5e",
      "name": "Customer Support Bot",
      "model": "gpt-4o",
      "system_prompt": "You are a helpful customer support agent...",
      "temperature": 0.5,
      "max_tokens": 1024,
      "status": "active",
      "created_at": "2025-03-10T08:00:00Z",
      "updated_at": "2025-03-12T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl https://api.chatsby.co/v1/agents/agent_1a2b3c4d5e \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.chatsby.co/v1/agents/agent_1a2b3c4d5e',
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
  }
);
 
const agent = await response.json();

curl -X PATCH https://api.chatsby.co/v1/agents/agent_1a2b3c4d5e \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system_prompt": "You are a senior support specialist for Acme Corp. Always greet users by name if available. Escalate billing issues to a human agent.",
    "temperature": 0.3
  }'

const response = await fetch(
  'https://api.chatsby.co/v1/agents/agent_1a2b3c4d5e',
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      system_prompt: 'You are a senior support specialist for Acme Corp.',
      temperature: 0.3,
    }),
  }
);
 
const agent = await response.json();

curl -X DELETE https://api.chatsby.co/v1/agents/agent_1a2b3c4d5e \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.chatsby.co/v1/agents/agent_1a2b3c4d5e',
  {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
  }
);
 
// 204 No Content on success

import { Chatsby } from '@chatsby/sdk';
 
const chatsby = new Chatsby({ apiKey: process.env.CHATSBY_API_KEY });
 
// Step 1: Create the agent
const agent = await chatsby.agents.create({
  name: 'Acme Support Bot',
  model: 'gpt-4o',
  system_prompt: `You are the Acme Corp support bot. Rules:
    1. Always be polite and professional.
    2. Only answer questions based on the provided sources.
    3. If unsure, ask the user to contact [email protected].`,
  temperature: 0.4,
  max_tokens: 1024,
});
 
console.log(`Agent created: ${agent.id}`);
 
// Step 2: Add knowledge sources
await chatsby.sources.create(agent.id, {
  type: 'website',
  content: 'https://acme.com/help',
});
 
await chatsby.sources.create(agent.id, {
  type: 'text',
  content: 'Acme Corp was founded in 2020. Our headquarters are in San Francisco.',
});
 
console.log('Sources added — they will begin processing immediately.');

// Iterate on the agent's instructions without recreating it
await chatsby.agents.update('agent_1a2b3c4d5e', {
  system_prompt: `You are the Acme Corp support bot. Updated rules:
    1. Always be polite and professional.
    2. Only answer questions based on the provided sources.
    3. If unsure, ask the user to contact [email protected].
    4. For billing questions, provide the billing portal link: https://acme.com/billing
    5. Never share internal pricing formulas.`,
});

let cursor = null;
const allAgents = [];
 
do {
  const params = new URLSearchParams({
    page_size: '50',
    status: 'active',
  });
  if (cursor) params.set('cursor', cursor);
 
  const response = await fetch(
    `https://api.chatsby.co/v1/agents?${params}`,
    { headers: { 'Authorization': `Bearer ${process.env.CHATSBY_API_KEY}` } }
  );
 
  const page = await response.json();
  allAgents.push(...page.data);
  cursor = page.has_more ? page.next_cursor : null;
} while (cursor);
 
console.log(`Found ${allAgents.length} active agents.`);