aYOUne
← KI / AI API

AIAgents

Singular: AIAgent — Base-URL: https://ai.ayoune.app — Zugriff: CRUD — Maschinenlesbare Beschreibung (JSON · YAML)

play_circle Jetzt ausprobieren beta

Requests werden über den consumer-app Proxy an *.ayoune.app weitergeleitet. Tokens bleiben im Browser und werden pro Call mitgesendet.

Beispiel-Response (aufgezeichnet) Beispiel

Eine echte, zuvor aufgezeichnete GET /:id-Antwort dieses Endpunkts — nicht der Live-Call oben. Sensible Felder sind maskiert.

{
  "payload": {
    "multimodalConfig": {
      "visionEnabled": false,
      "imageGenEnabled": false,
      "voiceEnabled": false
    },
    "scope": {
      "modules": [],
      "collections": [],
      "sourceTypes": [],
      "excludeCollections": [],
      "libraries": [],
      "languages": []
    },
    "ragConfig": {
      "topK": 10,
      "scoreThreshold": 0.7,
      "useHybridSearch": true,
      "rerankEnabled": false,
      "priorityCollections": []
    },
    "consumerConfig": {
      "allowedTopics": []
    },
    "routing": {
      "keywords": [],
      "canEscalate": false
    },
    "stats": {
      "totalConversations": 0,
      "totalMessages": 0
    },
    "ownership": {
      "primary": [],
      "shared": []
    },
    "qualityBar": {
      "definitionOfDone": [],
      "rubricCriteria": []
    },
    "workingRules": {
      "do": [
        "Identify automation opportunities (with n8n/RevOps)"
      ],
      "dont": [
        "Interpret numbers without Finance alignment"
      ]
    },
    "handoffs": {
      "upstream": [
        {
          "description": "team-finance, team-procurement",
          "_id": "6a353bd45a44977e01d46552",
          "isDraft": true
        }
      ],
      "downstream": [
        {
          "description": "team-finance (reports), team-businessplan (historicals)",
          "_id": "6a353bd45a44977e01d46553",
          "isDraft": true
        }
      ]
    },
    "orchestration": {
      "canSpawnSubAgents": false,
      "allowedSubAgents": [],
      "maxConcurrentTasks": 1
    },
    "memoryConfig": {
      "maxMemories": 100,
      "memoryAgingDays": 90,
      "teamMemoryEnabled": false
    },
    "costConfig": {
      "budgetAlertThreshold": 80
    },
    "_id": "6a353bd45a44977e01d46551",
    "name": "Accounting & Tax Specialist",
    "department": "finance",
    "type": "internal",
    "operatingLevel": "customer",
    "includeGlobalKnowledge": true,
    "status": "active",
    "systemPrompt": "You are an Accounting & Tax Specialist. Your mission is to structure accounting and tax-relevant workflows correctly and auditably. You handle receipt/coding logic, month-end checklists, VAT logic, cost centers, and process SOPs. Identify automation opportunities. Never interpret numbers without Finance alignment.",
    "modelName": "gpt-4o",
    "temperature": 0.3,
    "maxContextTokens": 8000,
    "isDefault": false,
    "global": false,
    "shared": false,
    "mission": "Structure accounting and tax-relevant workflows correctly and auditably.",
    "coreDuties": [
      "Receipt/coding logic",
      "Month-end checklists",
      "VAT logic",
      "Cost centers",
      "SOPs for accounting processes"
    ],
    "inputsNeeded": [],
    "outputsProduced": [],
    "escalationTriggers": [
      "Missing receipts",
      "Tax risk",
      "Month-end deadline"
    ],
    "inputChecklist": [],
    "permissionLevel": "read-only",
    "_allowedTools": [],
    "toolsEnabled": false,
    "_allowedCommands": [],
    "memoryEnabled": false,
    "version": 1,
    "isTemplate": false,
    "_clonedFrom": "69d358c67ba841b1ec29e1cd",
    "quickActions": [
      {
        "label": "Reconcile",
        "prompt": "Reconcile the following bank transactions:",
        "icon": "account_balance",
        "_id": "6a02bcfbf5cd121740805867",
        "isDraft": true
      },
      {
        "label": "Overdue",
        "prompt": "List overdue invoices grouped by customer.",
        "icon": "schedule",
        "_id": "6a02bcfbf5cd121740805868",
        "isDraft": true
      },
      {
        "label": "Margin",
        "prompt": "Calculate margins for:",
        "icon": "percent",
        "_id": "6a02bcfbf5cd121740805869",
        "isDraft": true
      },
      {
        "label": "Forecast cash",
        "prompt": "Forecast cash position for the next 30 days.",
        "icon": "savings",
        "_id": "6a02bcfbf5cd12174080586a",
        "isDraft": true
      }
    ],
    "isDraft": true,
    "createdAt": "2026-06-19T12:53:40.667Z",
    "updatedAt": "2026-06-19T12:53:40.667Z"
  },
  "meta": {
    "links": [
      {
        "rel": "self",
        "href": "https://ai.ayoune.app/aiagents/6a353bd45a44977e01d46551",
        "method": "get",
        "title": "GET",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      },
      {
        "rel": "AIAgents",
        "title": "MODEL_AIAGENT",
        "href": "https://api.ayoune.app/ai/aiagents/69d358c67ba841b1ec29e1cd",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ai.aiagents"
      }
    ],
    "relations": [
      {
        "rel": "AIModelCatalog",
        "title": "MODEL_AIMODELCATALOG",
        "href": "https://api.ayoune.app/ai/aimodelcatalog",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ai.aimodelcatalog"
      },
      {
        "rel": "AIProviders",
        "title": "MODEL_AIPROVIDER",
        "href": "https://api.ayoune.app/ai/aiproviders",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ai.aiproviders"
      },
      {
        "rel": "Teams",
        "title": "MODEL_TEAM",
        "href": "https://api.ayoune.app/config/teams",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "config.teams"
      },
      {
        "rel": "AIAgents",
        "title": "MODEL_AIAGENT",
        "href": "https://api.ayoune.app/ai/aiagents",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ai.aiagents"
      },
      {
        "rel": "Teams",
        "title": "MODEL_TEAM",
        "href": "https://api.ayoune.app/config/teams",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "config.teams"
      },
      {
        "rel": "AIAgents",
        "title": "MODEL_AIAGENT",
        "href": "https://api.ayoune.app/ai/aiagents",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ai.aiagents"
      },
      {
        "rel": "AIAgents",
        "title": "MODEL_AIAGENT",
        "href": "https://api.ayoune.app/ai/aiagents",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ai.aiagents"
      },
      {
        "rel": "AIAgents",
        "title": "MODEL_AIAGENT",
        "href": "https://api.ayoune.app/ai/aiagents",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ai.aiagents"
      },
      {
        "rel": "Employees",
        "title": "MODEL_EMPLOYEE",
        "href": "https://api.ayoune.app/hr/employees",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "hr.employees"
      }
    ],
    "debugId": "6a8a6b18860e841d7c8af4c3",
    "errors": [],
    "actions": [
      {
        "rel": "self",
        "action": "COPY",
        "title": "MODEL_AIAGENT",
        "href": "https://api.ayoune.app/ai/aiagents/6a353bd45a44977e01d46551/copy",
        "method": "post",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      },
      {
        "rel": "self",
        "action": "DELETE",
        "title": "MODEL_AIAGENT",
        "href": "https://api.ayoune.app/ai/aiagents/6a353bd45a44977e01d46551/copy",
        "method": "post",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      }
    ],
    "version": {
      "host": "2026.162.0",
      "core": "2026.315.1"
    },
    "rateLimit": {
      "limit": "10000",
      "remaining": "9860",
      "reset": "1787459872",
      "resetDate": "Sun Aug 23 2026"
    },
    "responseTime": 106.683108,
    "code": 200,
    "status": "success",
    "error": false
  }
}

Endpunkte

MethodePathBeschreibungRight
GET /aiagents Liste mit Filtern/Paginierung ai.aiagents.view
GET /aiagents/:id Einzelner Datensatz ai.aiagents.view
POST /aiagents Neuen Datensatz erstellen ai.aiagents.new
PUT /aiagents Datensatz aktualisieren ai.aiagents.edit
DELETE /aiagents/:id Datensatz löschen ai.aiagents.delete

SDK

import { aYOUne } from '@tolinax/ayoune';
const ay = new aYOUne('pat_your_token');

// Alle abrufen
const list = await ay.ai.aIAgents.find().limit(10).exec();

// Einzelnen Datensatz
const one = await ay.ai.aIAgents.findById('OBJECT_ID').exec();

// Erstellen
const created = await ay.ai.aIAgents.create({ name: 'Foo' });

Weiterführend