Agent-Tool-Beispiele

{
  "id": "019b...",
  "name": "Retouren",
  "count": 42,
  "filters": [ ... ]
}

[
  {
    "type": "function",
    "function": {
      "name": "list_inbox_views",
      "description": "Gespeicherte Posteingang-Ansichten mit Filtern und Ticket-Anzahl. Vor list_tickets nutzen, wenn der Nutzer eine Ansicht oder Filter (offen, Retouren, Kanal) meint.",
      "parameters": {
        "type": "object",
        "properties": {
          "limit": { "type": "integer", "description": "Max. Ansichten pro Seite (1-100)", "default": 50 },
          "cursor": { "type": "string", "description": "Pagination-Cursor aus vorherigem Aufruf" }
        }
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "list_tickets",
      "description": "Support-Tickets listen. view_id aus list_inbox_views für gespeicherte Filter.",
      "parameters": {
        "type": "object",
        "properties": {
          "view_id": { "type": "string", "description": "UUID einer gespeicherten Ansicht" },
          "limit": { "type": "integer", "default": 40 },
          "cursor": { "type": "string" },
          "include_ticket_fields": { "type": "boolean", "default": false }
        }
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_ticket_messages",
      "description": "Konversationsverlauf per Ticketnummer (z. B. 1234). order asc für Zusammenfassung.",
      "parameters": {
        "type": "object",
        "properties": {
          "ticket_number": { "type": "integer", "description": "Lesbare Ticketnummer" },
          "order": { "type": "string", "enum": ["asc", "desc"], "default": "asc" },
          "limit": { "type": "integer", "default": 30 },
          "cursor": { "type": "string" }
        },
        "required": ["ticket_number"]
      }
    }
  }
]

const BASE = 'https://api.armin.cx/public/v1'
const headers = { 'cx-api-key': process.env.CX_API_KEY! }

async function list_inbox_views(args: { limit?: number; cursor?: string }) {
  const params = new URLSearchParams()
  if (args.limit) params.set('limit', String(args.limit))
  if (args.cursor) params.set('cursor', args.cursor)
  const res = await fetch(`${BASE}/views?${params}`, { headers })
  return res.json()
}

async function list_tickets(args: {
  view_id?: string
  limit?: number
  cursor?: string
  include_ticket_fields?: boolean
}) {
  const params = new URLSearchParams()
  if (args.view_id) params.set('view_id', args.view_id)
  if (args.limit) params.set('limit', String(args.limit))
  if (args.cursor) params.set('cursor', args.cursor)
  if (args.include_ticket_fields) params.set('include', 'ticket_fields')
  const res = await fetch(`${BASE}/tickets?${params}`, { headers })
  return res.json()
}

async function get_ticket_messages(args: {
  ticket_number: number
  order?: 'asc' | 'desc'
  limit?: number
  cursor?: string
}) {
  const params = new URLSearchParams()
  if (args.order) params.set('order', args.order)
  if (args.limit) params.set('limit', String(args.limit))
  if (args.cursor) params.set('cursor', args.cursor)
  const res = await fetch(
    `${BASE}/tickets/${args.ticket_number}/messages?${params}`,
    { headers },
  )
  return res.json()
}

{
  "name": "list_inbox_views",
  "description": "Gespeicherte Posteingang-Ansichten. Liefert id, name, count, filters. Aufrufen, wenn der Nutzer eine Ansicht nach Name meint oder gefilterte Ticket-Listen will.",
  "input_schema": {
    "type": "object",
    "properties": {
      "limit": { "type": "integer", "maximum": 100 },
      "cursor": { "type": "string" }
    }
  }
}