Versions

AGENT_ID=9f1c0a3e-4b21-4f7a-9c6d-2a5b8e13d704

# 1. Create the tool
TOOL=$(curl -sS https://api.in.talqing.com/v1/tools \
  -H "Authorization: Bearer $TALQING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "check_order",
    "description": "Look up the status of a customer order by its id.",
    "json_schema": {
      "type": "object",
      "properties": { "order_id": { "type": "string" } },
      "required": ["order_id"]
    },
    "operations": [
      {
        "kind": "http",
        "config": {
          "method": "GET",
          "url": "https://api.example.com/orders/{{args.order_id}}"
        }
      }
    ]
  }')
TOOL_ID=$(echo "$TOOL" | jq -r .id)

# 2. Validate, then 3. publish the tool
curl -sS -X POST "https://api.in.talqing.com/v1/tools/$TOOL_ID/validate" \
  -H "Authorization: Bearer $TALQING_API_KEY"
curl -sS -X POST "https://api.in.talqing.com/v1/tools/$TOOL_ID/publish" \
  -H "Authorization: Bearer $TALQING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"changelog": "first version"}'

# 4. Attach it — the whole config, not a patch
curl -sS -X PATCH "https://api.in.talqing.com/v1/agents/$AGENT_ID" \
  -H "Authorization: Bearer $TALQING_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"config\": {
      \"name\": \"Order desk\",
      \"channel\": \"voice\",
      \"prompt\": \"You are the order desk for Example Retail. Ask for the order id, look it up with check_order, and read the status back plainly.\",
      \"greeting\": \"Hi, order desk here. Do you have your order number?\",
      \"language\": \"en-IN\",
      \"tools\": [{\"tool_id\": \"$TOOL_ID\"}]
    }
  }"

# 5. Validate, then 6. publish the agent
curl -sS -X POST "https://api.in.talqing.com/v1/agents/$AGENT_ID/validate" \
  -H "Authorization: Bearer $TALQING_API_KEY"
curl -sS -X POST "https://api.in.talqing.com/v1/agents/$AGENT_ID/publish" \
  -H "Authorization: Bearer $TALQING_API_KEY"

import { TalqingClient } from "@talqing/sdk";

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

const agentId = "9f1c0a3e-4b21-4f7a-9c6d-2a5b8e13d704";

const tool = await talqing.tools.create({
  createToolRequest: {
    name: "check_order",
    description: "Look up the status of a customer order by its id.",
    json_schema: {
      type: "object",
      properties: { order_id: { type: "string" } },
      required: ["order_id"],
    },
    operations: [
      {
        kind: "http",
        config: {
          method: "GET",
          url: "https://api.example.com/orders/{{args.order_id}}",
        },
      },
    ],
  },
});

const toolReport = await talqing.tools.validate({ tool_id: tool.id });
if (toolReport.errors.length) throw new Error(toolReport.errors.join("; "));
await talqing.tools.publish({
  tool_id: tool.id,
  publishToolRequest: { changelog: "first version" },
});

// The config is the whole definition, so start from what is stored.
const agent = await talqing.agents.get({ agent_id: agentId });
await talqing.agents.update({
  agent_id: agentId,
  updateAgentRequest: {
    config: { ...agent.config, tools: [{ tool_id: tool.id }] },
  },
});

const report = await talqing.agents.validate({ agent_id: agentId });
if (report.errors.length) throw new Error(report.errors.join("; "));
report.warnings.forEach((w) => console.warn(w));

const published = await talqing.agents.publish({ agent_id: agentId });
console.log(`live on v${published.version} at ${published.published_at}`);

from talqing import Talqing

agent_id = "9f1c0a3e-4b21-4f7a-9c6d-2a5b8e13d704"

with Talqing.from_env() as talqing:
    tool = talqing.tools.create(
        name="check_order",
        description="Look up the status of a customer order by its id.",
        json_schema={
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
        operations=[
            {
                "kind": "http",
                "config": {
                    "method": "GET",
                    "url": "https://api.example.com/orders/{{args.order_id}}",
                },
            }
        ],
    )

    tool_report = talqing.tools.validate(tool["id"])
    if tool_report["errors"]:
        raise SystemExit("\n".join(tool_report["errors"]))
    talqing.tools.publish(tool["id"], changelog="first version")

    # The config is the whole definition, so start from what is stored.
    agent = talqing.agents.get(agent_id)
    talqing.agents.update(
        agent_id,
        config={**agent["config"], "tools": [{"tool_id": tool["id"]}]},
    )

    report = talqing.agents.validate(agent_id)
    if report["errors"]:
        raise SystemExit("\n".join(report["errors"]))
    for warning in report["warnings"]:
        print("warning:", warning)

    published = talqing.agents.publish(agent_id)
    print(f"live on v{published['version']} at {published['published_at']}")

# Every publish, newest first
curl -sS "https://api.in.talqing.com/v1/agents/$AGENT_ID" \
  -H "Authorization: Bearer $TALQING_API_KEY" | jq '.published_version, .versions'

# One version's frozen config, tool pins included
curl -sS "https://api.in.talqing.com/v1/agents/$AGENT_ID/versions/4" \
  -H "Authorization: Bearer $TALQING_API_KEY" | jq '.config.tools'

# Put v4 back into production
curl -sS -X POST "https://api.in.talqing.com/v1/agents/$AGENT_ID/versions/4/rollback" \
  -H "Authorization: Bearer $TALQING_API_KEY"

const { published_version, versions } = await talqing.agents.get({ agent_id: agentId });
console.log(published_version, versions);

const v4 = await talqing.agents.versions.get({ agent_id: agentId, version: 4 });
console.log(v4.config.tools); // [{ tool_id: "…", tool_version: 3 }]

await talqing.agents.versions.rollback({ agent_id: agentId, version: 4 });

agent = talqing.agents.get(agent_id)
print(agent["published_version"], agent["versions"])

v4 = talqing.agents.versions.get(agent_id, 4)
print(v4["config"]["tools"])  # [{"tool_id": "…", "tool_version": 3}]

talqing.agents.versions.rollback(agent_id, 4)