Quickstart: text agent

import { randomUUID } from "node:crypto";
import { TalqingClient } from "@talqing/sdk";

const token = process.env.TALQING_API_KEY;
if (!token) throw new Error("TALQING_API_KEY is required");

const talqing = new TalqingClient({
  baseUrl: "https://api.talqing.com",
  token,
});

// 1. Create the agent.
const agent = await talqing.agents.create({
  createAgentRequest: {
    config: {
      name: "Northwind support",
      channel: "text",
      prompt: [
        "You are the support assistant for Northwind Tools, an online hardware store.",
        "Answer questions about orders, delivery and returns.",
        "Ask for the order number before you discuss a specific order.",
        "If you do not know something, say so plainly instead of guessing.",
        "Keep replies to two or three sentences.",
      ].join(" "),
      llm: { provider: "openai", model: "gpt-5.6-luna" },
    },
  },
});

// 2. Publish it. Nothing can talk to a draft.
await talqing.agents.publish({ agent_id: agent.id });

// 3. Start a chat. `contact_key` is your own id for the person.
const chat = await talqing.chats.create({
  createChatRequest: { contact_key: "user-42", agent_id: agent.id },
});

// 4. Say something. The reply comes back on this request.
const turn = await talqing.chats.messages.create({
  chat_id: chat.id,
  chatMessageRequest: {
    client_message_id: randomUUID(),
    message: "My order 10432 never arrived. What happens now?",
  },
});

if (turn.status !== "done") throw new Error(turn.error ?? `the turn ended ${turn.status}`);
for (const item of turn.items) {
  if (item.type === "message") console.log(item.text);
}

// 5. End the chat. Left open, it ends 24 hours after the last message.
await talqing.chats.end({ chat_id: chat.id });

import os
from uuid import uuid4

from talqing import Talqing

with Talqing(
    token=os.environ["TALQING_API_KEY"],
    base_url="https://api.talqing.com",
) as talqing:
    # 1. Create the agent.
    agent = talqing.agents.create(
        config={
            "name": "Northwind support",
            "channel": "text",
            "prompt": (
                "You are the support assistant for Northwind Tools, an online hardware store. "
                "Answer questions about orders, delivery and returns. "
                "Ask for the order number before you discuss a specific order. "
                "If you do not know something, say so plainly instead of guessing. "
                "Keep replies to two or three sentences."
            ),
            "llm": {"provider": "openai", "model": "gpt-5.6-luna"},
        }
    )

    # 2. Publish it. Nothing can talk to a draft.
    talqing.agents.publish(agent["id"])

    # 3. Start a chat. `contact_key` is your own id for the person.
    chat = talqing.chats.create(contact_key="user-42", agent_id=agent["id"])

    # 4. Say something. The reply comes back on this request.
    turn = talqing.chats.messages.create(
        chat["id"],
        client_message_id=str(uuid4()),
        message="My order 10432 never arrived. What happens now?",
    )

    if turn["status"] != "done":
        raise RuntimeError(turn["error"] or f"the turn ended {turn['status']}")
    for item in turn["items"]:
        if item["type"] == "message":
            print(item["text"])

    # 5. End the chat. Left open, it ends 24 hours after the last message.
    talqing.chats.end(chat["id"])