Zum Hauptinhalt springen

Erstellen und Ausführen eines Agenten

Ein Agent ist ein Sprachmodell mit einer Systemeingabeaufforderung, einer Reihe von Werkzeugen, die er aufrufen kann, und optional weiteren Agenten, an die er Aufgaben delegieren kann. Sie sprechen mit ihm, und er entscheidet in jedem Schritt, ob er ein Werkzeug aufruft, einen Teil der Aufgabe an einen Unteragenten weitergibt oder die Anfrage beantwortet.

Diese Anleitung führt Sie von einem leeren Projekt zu einem bereitgestellten Agenten, den Sie Tiet · Studio getestet und über die API aufgerufen haben. Das Beispiel kopiert einen realen Katalogagenten, ändert ihn und stellt ihn bereit.

Agenten-, Workflow- oder Agentengraph​

Du brauchstVerwendenWarum
Ein Gespräch oder eine offene Aufgabe, bei der das Modell entscheidet, welche Werkzeuge es verwendet.Agent (diese Seite)Eine Eingabeaufforderung, ein Modell, Werkzeuge werden zur Laufzeit ausgewählt. Streamt eine Chat-Antwort.
Immer die gleichen, festgelegten Schritte, von Ihnen verdrahtet, ohne dass ein Modell die Reihenfolge vorgibtWorkflow im Builder: Erstellen Sie beliebige WorkflowsDeterministische Knoten. Ein Workflow kann weiterhin einen Agent Executor Knoten enthalten, wenn ein Schritt ein Modell mit Werkzeugen benötigt.
Mehrere Modellphasen mit unterschiedlichen Rollen oder Modellen, pro Phase fixiert, mit einer Aufzeichnung pro SchrittAgent graph: Erstelle einen AgentengraphenVersionierter Graph von LLM-Knoten, der als eine einzige Ausführung läuft. Langsamer und kostspieliger als ein einzelner Agent.

Beginnen Sie mit einem einzelnen Agenten. Wechseln Sie erst dann zu einem Graphen, wenn eine einzelne Eingabeaufforderung die Logik nicht abbilden kann oder Sie für jede Phase unterschiedliche Modelle benötigen.

Wie ein Agent antwortet​

Der Agentenkreislauf: Das Modell denkt, ruft dann ein Werkzeug auf, delegiert an einen Unteragenten oder antwortet; die Ergebnisse werden beobachtet und für die nächste Runde zurückgemeldet.

  • Tools sind Aktionen, die der Agent aufrufen kann, z. B. pubmed, medical-calculator oder memory. Sie weisen diese im Design-Tab zu. Ein Werkzeug, dessen Wirkung die Autonomiegrenze des Laufs überschreitet, wird dem Modell überhaupt nicht angeboten (siehe Agenten und Governance).
  • Sub-agents sind andere Agenten, an die der Agent delegieren kann. Jeder dieser Agenten wird dem übergeordneten Agenten als Tool mit dem Namen agent_<tool_name> bereitgestellt und läuft mit eigener Eingabeaufforderung und eigenen Tools.
  • Models stammen aus der Registrierung in Tiet · Agentic → Agents → Models. Im Abschnitt Model der Registerkarte „Design“ wird eines ausgewählt. Verschiedene Modelle können verschiedenen Phasen zugeordnet werden (siehe unten).
  • Beim Erstellen des Agenten wird Agent type festgelegt: Conversational (Mehrrunden-Chat mit Gedächtnis), Task (Einzelaufgabe), Hybrid (Chat plus Aufgabe) oder ReAct (Analyse-, Handlungs- und Beobachtungsschleife mit Tools). Verwenden Sie ReAct für einen Agenten, der auf Tools angewiesen ist.

Wo die Dinge sind​

Öffnen Sie Tiet · Agentic → Agents. Die Seite enthält sechs Registerkarten: Agents, Agent Graphs, Agent Catalog, Models, Tools und Skills. Sie sehen nur die Registerkarten, für die Sie Berechtigungen haben. Oben rechts befinden sich die Auswahlfelder Project, Run in und New Agent. Run in wählen Sie die Umgebung aus, in der die von Studio gestartete Anwendung ausgeführt wird (standardmäßig die Organisationsumgebung, sofern Sie keine andere auswählen). In einer Umgebung, die Entwürfe zulässt, wird das vom Editor angeforderte Dokument ausgeführt; in allen anderen Umgebungen werden nur die bereitgestellten Versionen ausgeführt. Siehe Umgebungen & Freigabe.

Die Seitenleiste enthält außerdem drei Geschwister unter Tiet · Agentic → Agents:

  • Hier Agent Workspace können Sie mit einem Agenten chatten oder einen Lauf starten.
  • Monitor (Agent activity) listet die letzten Ausführungen über alle Agenten und Graphen hinweg auf.
  • Reviews (SEPL commit reviews) listet vorgeschlagene Agentenänderungen auf, die auf eine menschliche Entscheidung warten, und zwar für alle Agenten. Siehe Agenten und Governance.

Agenten erstellen​

Es gibt drei Möglichkeiten, einen Agenten in Ihr Projekt einzubinden.

Die Agent Catalog enthält Tietai verwaltete Basisagenten. Etwa 110 davon sind im Einsatz und decken Bereiche wie Kodierung und Abrechnung, klinische Entscheidungsunterstützung, Dokumentation, Pflege, Pharmazie, Spezialversorgung, Betriebsabläufe und mehr ab. Es handelt sich um getestete Ausgangspunkte mit realen Eingabeaufforderungen und Werkzeuglisten.

  1. Wählen Sie oben rechts Ihre Project aus. Sie benötigen eine; ohne sie kann keine Kopie erstellt werden.
  2. Öffnen Sie den Reiter Agent Catalog oder klicken Sie auf New Agent → Start from a Tietai base agent.
  3. Finden Sie den Agenten. Im Suchfeld des Katalogs steht: „Agenten nach Namen, Beschreibung oder Schlagwörtern suchen…“.
  4. Klicken Sie auf Deploy to my org. Geben Sie Agent Name und dann Deploy ein.

Das Ergebnis ist eine bearbeitbare Kopie in Ihrem Projekt, die im Designer geöffnet wird. Trotz der Schaltflächenbeschriftung ist die Kopie noch nicht bereitgestellt: Sie ist aktiv, die Versionsnummer entspricht der des Basisagenten, die Werkzeugzuweisungen wurden kopiert und die Subagenten-Referenzen wurden per Referenz kopiert. Die Kopie merkt sich die ursprüngliche Vorlage, und im Verlauf wird bei einer späteren Aktualisierung der Vorlage der Wert Review Changes angezeigt.

Ganz von vorn beginnen​

  1. Klicken Sie auf New Agent, dann Start from scratch („Konfigurieren Sie einen leeren Agenten mit Ihren eigenen Einstellungen.“).
  2. Füllen Sie das Feld New Agent aus:
FeldBedeutungBeispiel
NameErforderlich.Discharge Summary Helper
TypeKonversationell, Aufgabenorientiert, Hybrid oder ReAct. Standardmäßig konversationell.Reagieren
DescriptionOptional.Drafts a discharge summary from a pasted note.
ProjectAus der Projektauswahl. Der Dialog warnt: „Kein aktives Projekt – wählen Sie zuerst ein Projekt aus.“ und Create bleibt deaktiviert, bis ein Projekt ausgewählt ist.Demo-Projekt
  1. Klicken Sie auf Create. Der Designer öffnet sich. Systemeingabeaufforderung, Werkzeuge und Modell sind dort eingerichtet.

Einen vorhandenen Agenten duplizieren​

Öffnen Sie auf einer Agentenkarte das Aktionsmenü und wählen Sie Duplicate. Die Kopie erhält den Namen <name> (Copy) und enthält Tools, Skills und Richtlinien. Sie wird absichtlich inaktiv erstellt und niemals als bereitgestellte oder in Inference veröffentlichte Kopie kopiert. Falls einige verknüpfte Elemente nicht kopiert werden konnten, wird die Meldung angezeigt: „… wurde erstellt, aber N verknüpfte Konfigurationselemente konnten nicht kopiert werden. Überprüfen Sie das Duplikat vor der Verwendung.“ Der Designer bietet keine Möglichkeit, einen inaktiven Agenten wieder zu aktivieren. Verwenden Sie daher für eine Kopie, die Sie ausführen möchten, den oben beschriebenen Katalogweg.

Agenten in ein anderes Projekt versetzen​

Auf einer Agentenkarte enthält das Aktionsmenü Move to project…. Einträge. Aktivieren Sie die Kontrollkästchen auf mehreren Karten (mit gedrückter Umschalttaste wird ein Bereich ausgewählt) und verschieben Sie diese mithilfe der Auswahlleiste gemeinsam. Es ändert sich nur das Projekt. Katalogstammdaten-Agenten und Agenten anderer Organisationen können nicht verschoben werden. Zum Aktualisieren von Agenten benötigen Sie die Berechtigung dazu. Das Zielprojekt muss zur selben Organisation gehören.

Der Agentendesigner​

Klicken Sie auf einen Agenten, um den Designer zu öffnen. Die Registerkarten sind:

TabWas es enthält
DesignDie Konfiguration: Identität, Eingabeaufforderung, Variablen, Werkzeuge, Fähigkeiten, Ausführung, Subagenten, Speicher, Modell. Schaltflächen „Speichern“ und „Bereitstellen“ auf der rechten Seite.
PoliciesGovernance-Regeln für diesen Agenten. New Policy bietet fünf Typen: IntentGuard (Benutzerabsichten blockieren, die einem Auslöser entsprechen), Playbook (Schritt-für-Schritt-Anleitung in die Systemeingabeaufforderung einfügen), ToolGuide (Hinweise zur Beschreibung eines Tools hinzufügen), ToolApproval (vor dem Aufruf eines Tools eine menschliche Genehmigung einholen, mit einem Timeout in Minuten) und OutputFormatter (Formatierungsanweisungen für die endgültige Antwort). Auslöser: Schlüsselwort, semantisch, Toolname oder immer. Jede Richtlinie hat eine Priorität und einen Aktivierungsschalter.
ActivitySchrittweise Aufzeichnung einer Sitzung: Wählen Sie eine Sitzung aus, sehen Sie sich deren Schritte und Dauer an und öffnen Sie sie im Trace Explorer. Leer, bis der Agent ausgeführt wurde („Noch keine Sitzungen. Führen Sie den Agenten aus, um die Aktivität anzuzeigen.“).
TestChat mit dem bereitgestellten Agenten: Ask the Agent, Test Inputs (gespeicherte Nachrichten und Dateien mit optionalem erwarteten Ergebnis) und Execution History.
ValidateRun Validation prüft die Konfiguration und listet Probleme nach Feld auf, zum Beispiel prompt_template: system prompt is required und model_config: model configuration is required.
HistoryDie Versionsliste. New draft version beginnt einen Entwurf mit optionalen Änderungshinweisen.
APIAPI-Schlüssel für diesen Agenten, der Aufruf-Endpunkt, das Anfrageschema und Codebeispiele in cURL, TypeScript, Python und Java.
EvolutionSelbstlernende Eingabeaufforderungen (SEPL): Modus, Run Evolution, Parameter, ausstehende Überprüfungen und Verlauf. Siehe Agenten und Governance.

Die obere Leiste zeigt den Agentennamen, eine Versionsauswahl, ein Deployed Symbol für den Live-Status und eine Copilot Schaltfläche, die neben den Registerkarten ein Assistenten-Panel öffnet. Benutzer mit der Rolle „Plattformmanager“ sehen zusätzlich Publish to Catalog.

Die Registerkartenabschnitte „Design“​

AbschnittFelder und Steuerelemente
IdentityName, Beschreibung, Version, Tags (Tag eingeben und Enter drücken), Agententyp.
PromptSystem Prompt: Wird zu Beginn jeder Konversation an das Modell gesendet. Tragen Sie {{name}} für einen Wert ein, den Sie pro Aufruf festlegen (die Invoke-API ruft diese variables auf). Bei aktiviertem Modell-Routing ergeben sich daraus vier Eingabeaufforderungen pro Phase (Planung, Werkzeugaufruf, Reasoner, Synthese) sowie eine Standardeingabeaufforderung für leere Phasen.
VariablesLegt fest, welche Informationen ein Anrufer für jede {{name}} in der Eingabeaufforderung angibt: Name, Typ (Zeichenkette, Text, Zahl oder boolescher Wert), erforderlich und ein Beispiel. Verwenden Add variable oder Declare N from the prompt um die von der Eingabeaufforderung verwendeten Platzhalter hinzuzufügen, die Sie nicht deklariert haben. Maximal 50. Deklarationen werden mit dem Agenten versioniert und Variablenvoreinstellungen werden damit abgeglichen (ein fehlender erforderlicher Wert, eine Nicht-Zahl oder eine Zeichenkette mit mehr als 1000 Zeichen wird abgelehnt; lange Werte werden als text deklariert). Der Aufrufendpunkt selbst erzwingt diese nicht.
ToolsAlle Ihrer Organisation zur Verfügung stehenden Tools sind nach Kategorien gruppiert. Klicken Sie auf ein Tool, um es zuzuweisen oder zu entfernen. Wenn Sie ein Tool zuweisen, das Aktionen ausführen darf (und nicht nur lesen kann), wird zunächst ein Dialogfeld zur Überprüfung der Berechtigungen angezeigt.
SkillsDie Funktion packt die Modelllasten bedarfsgerecht. Der automatische Schalter fügt die Anweisungen einer Fertigkeit vor der ersten Modellrunde ein.
ExecutionDefault Execution Mode (Schnell, Ausgewogen, Genau), Auto Variable Tracking, Auto Planning, Model Routing (ein Modell pro Phase), Shortlister (ordnet Werkzeuge nach Relevanz; benötigt Qdrant) und Code-Act Mode.
Sub-AgentsAdd Sub-Agent. Für jedes: Agent ID, Tool Name, Invocation (sequential, parallel, fire-and-forget) und Description („Wann an diesen Agenten delegiert werden soll“).
MemoryEnable memory, dann Speichertyp (episodisch, semantisch, prozedural, Arbeitsspeicher), Speicher-Backend und eine Abrufstrategie für das Memora-Backend.
ModelModel Auswahl (mit "Schlüsselsatz" oder "kein Schlüssel" für das ausgewählte Modell), Temperature, Max Tokens (256 bis 128000), Enable streaming, und Manage model credentials.

Die rechte Spalte enthält Save Changes, Deploy, ein Kontrollkästchen Publish to Inference (macht den Agenten zu einer Vorlage auf der Seite „Medizinische Schlussfolgerung“) und ein Feld Status (Aktiv, Bereitgestellt, Veröffentlicht, Aktuell).

hinweis

Der Wert Invocation wird mit jeder Subagentenreferenz gespeichert. Im Chat- und Aufrufpfad wird jeder Subagent als aufrufbares Tool mit dem Namen agent_<tool_name> registriert, und das Modell entscheidet, wann es aufgerufen wird; in diesem Pfad gibt es keine Verzweigungen zu sequential, parallel oder fire-and-forget. Verlassen Sie sich nicht darauf, dass der Modus die Funktionsweise der Delegation ändert.

Eine Delegierung wird standardmäßig nach 20 Modellaufrufen oder 10 Werkzeugaufrufen aufgrund eines Fehlers abgebrochen, den der übergeordnete Prozess als fehlgeschlagenen Werkzeugaufruf erkennt. Pro Serverprozess ist die Anzahl der Delegierungen auf 30 pro Stunde begrenzt. Ist der max_sub_agent_depth nicht festgelegt, beträgt die maximale Tiefe 2.

Versionen: Entwurf, Bereitstellung, Eingefroren​

Lebenszyklus der Agentenversion: nicht bereitgestellt, bereitgestellt und eingefroren, neue Entwurfsversion, erneut bereitgestellt

  • Ein nicht bereitgestellter Agent wird direkt bearbeitet. Save Changes fragt optional nach Änderungshinweisen und erhöht die Patch-Version (z. B. 1.1.0 auf 1.1.1).
  • Deploy speichert die aktuelle Konfiguration als bereitgestellte Version und markiert den Agenten als aktiv. Die Registerkarte „Testen“, der Agenten-Arbeitsbereich und die API-Aufruffunktion führen die bereitgestellte Konfiguration aus.
  • Eine bereitgestellte Version ist eingefroren. Das Speichern von Änderungen wird mit HTTP-Fehler 409 und dem Code AGENT_DEPLOYED_IMMUTABLE abgelehnt, und der Designer meldet: „Diese Version ist bereitgestellt und unveränderlich. Erstellen Sie eine neue Version, um sie zu ändern.“ Name, Beschreibung, Tags, Projekt und die Inferenz-Einstellungen bleiben weiterhin bearbeitbar.
  • Um einen bereitgestellten Agenten zu ändern, klicken Sie auf New version (oder New draft version im Verlauf). Sie bearbeiten den Entwurf; der laufende Agent bleibt unverändert. Klicken Sie anschließend Save draft und dann Deploy vX.Y.Z. Discard draft wird der Entwurf verworfen.
  • Jede Version bleibt lesbar. Um eine ältere Version wiederherzustellen, erstellen Sie einen Entwurf basierend auf dieser („Neue Version basierend auf dieser“) und stellen Sie ihn bereit.
  • Werkzeug- und Kompetenzzuweisungen sind nicht Teil einer Version. Sie können live bearbeitet werden und sind nicht an die Version gebunden. Deklarierte Variables sind Teil der Version.

Der Designer hat keine Undeploy Taste, die API hingegen POST /api/agents/{id}/undeploy.

Beispiel: Kopieren, Anpassen, Testen, Bereitstellen, Aufrufen​

Sie kopieren den Katalogagenten Laboratory Results Interpreter, fügen eine Regel hinzu und rufen ihn auf. Seine Katalogdefinition: Typ react, Modell gemini-2.5-pro (Anbieter google), Temperatur 30, max. Token 8192, compliance_level: hipaa, Werkzeuge medical-calculator, pubmed, memory und ui, keine Subagenten. Seine Eingabeaufforderung interpretiert Laborergebnisse anhand von Referenzbereichen, filtert nach kritischen Werten und präanalytischen Problemen wie Hämolyse und erstellt Markdown-Abschnitte wie ## Result Summary und ## Critical Value Screen.

Verwenden Sie ausschließlich synthetische Daten.

1. Kopiere es​

  1. Wählen Sie ein Projekt aus.
  2. Tiet · Agentic → Agents → Agent Catalog. Suche nach „Labor“.
  3. Bei Laboratory Results Interpreter klicken Sie auf Deploy to my org, stellen Sie Agent Name auf Lab Interpreter (Demo Hospital) und klicken Sie auf Deploy.

Sie gelangen in den Designer. In der oberen Leiste werden die Symbole v1.1.0 und Deployed angezeigt. In Tools (4) sind die vier Werkzeuge ausgewählt.

2. Passen Sie es an.​

  1. Design → Identity: Ändere Description in Interprets lab results for Demo Hospital clinicians.
  2. Policies → New Policy → Playbook Benennen Sie es Units on every value, stellen Sie den Auslöser auf immer ein und schreiben Sie in Instructions (Markdown). 1. Print every value with the unit exactly as reported by the source laboratory. Klicken Sie Create Policy.
  3. Design → Save Changes, fügen Sie die Notiz Demo Hospital description hinzu und bestätigen Sie. Die Version wird zu 1.1.1.

Eine Playbook-Richtlinie fügt Ihre Anweisungen in die Systemeingabeaufforderung ein, ohne dass Sie die Katalogeingabeaufforderung bearbeiten müssen, die lang ist und einen eigenen Ausgabevertrag enthält. Richtlinien sind nicht Teil einer Version, daher können Sie sie auch nach der Bereitstellung ändern.

3. Validieren und bereitstellen​

  1. Validate → Run Validation. Sie sollten Agent is valid sehen. Falls nicht, wird das Feld in jedem Problem benannt.
  2. Design → Deploy Das Deployed Badge erscheint und die Registerkarte „Test“ wird nutzbar.

4. Teste es.​

  1. Öffnen Sie die Registerkarte Test Vor der Bereitstellung wird die Meldung „Agent nicht bereitgestellt“ angezeigt. Stellen Sie den Agenten über die Registerkarte „Design“ bereit, um mit dem Testen zu beginnen.

  2. In Ask the Agent, sende:

    Test Patient A, 54 years old. Potassium 6.4 mmol/L, creatinine 2.1 mg/dL.
    The specimen is marked hemolyzed. Interpret these results.
  3. Sie sollten den Antwortstream mit den vom Agenten durchgeführten Toolaufrufen sehen. Prüfen Sie, ob er auf einen kritischen Wert prüft, Hämolyse als mögliche präanalytische Ursache meldet und die Einheiten ausgibt.

  4. Öffnen Sie Activity, um die gleiche Sitzung Schritt für Schritt anzuzeigen, und Test → Execution History für den Ausführungsbericht.

Um eine Nachricht für später aufzubewahren, verwenden Sie Test Inputs: Geben Sie eine Input name, die Message, optionale Anhänge und eine optionale Expected result ein.

5. Chatten Sie mit ihm im Agenten-Arbeitsbereich.​

  1. Tiet · Agentic → Agents → Agent Workspace. Der Launcher listet Ihre aktiven Agenten und Diagramme als Karten, sortiert nach Namen, auf. Ein Konversations-, Hybrid- oder ReAct-Agent befindet sich im Modus Ask; ein Aufgabenagent im Modus Tool.
  2. Öffnen Sie die Karte Ihres Agenten und klicken Sie auf Start conversation. Geben Sie „Folgeanfrage senden, Link einfügen oder Datei anhängen…“ ein. Auf dem Bildschirm wird der Hinweis „Nur für klinische Entscheidungsunterstützung“ angezeigt.

6. Rufen Sie es über die API auf.​

  1. Öffnen Sie den Tab API und klicken Sie auf Generate Key. Geben Sie Name, optional Description, Expires in (30 Tage, 90 Tage, 1 Jahr oder Nie), Rate limit (Anfragen pro Minute, 0 = unbegrenzt) und optional IP whitelist (eine pro Leitung) ein. Der Schlüssel ist auf diesen Agenten beschränkt (agent:<agent id>:execute).

  2. Kopieren Sie das Token sofort: „Speichern Sie dieses Token – es wird nicht wieder angezeigt.“

  3. Den Endpunkt aufrufen. Über das Gateway ist der Pfad /api/v1/hydra-platform/v1/agents/{id}/invoke:

    curl -X POST https://api.tiet.ai/api/v1/hydra-platform/v1/agents/AGENT_ID/invoke \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "message": "Test Patient A. Potassium 6.4 mmol/L, hemolyzed specimen. Interpret.",
    "stream": false
    }'

Der API-Tab füllt die Felder AGENT_ID und Ihre eigenen {{variable}} Namen automatisch aus.

AnforderungsfeldTypAnmerkungen
messageZeichenketteErforderlich, es sei denn, Sie senden attachments.
variablesObjekt von ZeichenkettenWerte für die {{name}} Platzhalter in der Eingabeaufforderung.
streamboolescher Werttrue gibt Server-Sent Events (data: {...}. Frame) zurück. Das Streaming-Beispiel auf der API-Registerkarte fügt Accept: text/event-stream hinzu.
historyArray von {role, content}Frühere Gesprächsrunden, wenn Sie das Gespräch selbst führen.
attachmentsArrayDateien für das Modell; werden anstelle oder zusammen mit einer Nachricht gesendet.

Bei stream: false ist die Antwort ein einzelnes JSON-Objekt. Es enthält content (die Antwort), input_tokens und output_tokens sowie, wenn die Tools ausgeführt wurden, tool_calls und tool_trace. Bei stream: true endet der Stream mit einem Frame, der "done": "true", die Tokenanzahl und final_content enthält; ein Fehler beendet ihn mit {"type": "error", ...}.

7. Ändern Sie es nach der Bereitstellung.​

  1. Öffnen Sie den Agenten und die Registerkarte Design Es erscheint ein Banner mit dem Hinweis, dass die laufende Konfiguration nicht direkt bearbeitet werden kann.
  2. Klicken Sie auf New version, bearbeiten Sie den Entwurf, dann auf Save draft und anschließend Deploy v1.1.2.
  3. History listet nun die früheren Versionen und die neue Version auf. Die älteren, bereits eingesetzten Versionen sind weiterhin lesbar.

Überwachen Sie, was die Agenten tun​

Tiet · Agentic → Agents → Monitor („Agentenaktivität: Aktuelle Ausführungen aller Agenten und Subagenten“) zeigt Kacheln für Runs, Success rate, Failed, Running now, Avg duration und Cost, Filter für Typ, Status, Zeitraum, Agent und Name sowie eine Tabelle Executions mit Agent, Typ, Status, Startdatum, Dauer, Token, Kosten, Auslöser und einem Link zum Trace. Der API-Aufruf aus Schritt 6 wird hier angezeigt.

Grenzen​

  • Auf der Registerkarte „Test“ wird nur ein bereitgestellter Agent ausgeführt.
  • Werkzeug- und Kompetenzzuweisungen sind live und werden nicht versioniert.
  • Die Modi des Unteragenten Invocation werden gespeichert, aber nicht im Chatverlauf angewendet (siehe oben).
  • Modell-Fallback, dauerhafte Ausführungen und Schleifenschutz gehören zu den Knoten des Agentengraphen, nicht zu einem einzelnen Agenten. Siehe Agenten und Governance.
  • Die Basisagenten des Katalogs sind für Sie schreibgeschützt. Nur ein Plattformmanager kann sie bearbeiten, und Änderungen wirken sich auf alle Organisationen aus.

Fehlerbehebung​

Sie sehenUrsache und Lösung
Create ist deaktiviert und im Dialogfeld erscheint die Meldung „Kein aktives Projekt – wählen Sie zuerst ein Projekt aus“.Wählen Sie oben rechts im Projektauswahlfeld ein Projekt aus.
New Agent Taste fehltSie verfügen nicht über die Berechtigung zum Erstellen von Agenten. Wenden Sie sich an einen Organisationsadministrator.
Registerkarte „Test“: „Agent nicht bereitgestellt“Klicken Sie auf der Registerkarte „Design“ auf Deploy (speichern Sie zuerst; die Bereitstellung ist deaktiviert, solange ungespeicherte Änderungen vorhanden sind).
„Diese Version ist im Einsatz und unveränderlich. Erstellen Sie eine neue Version, um sie zu ändern.“ (409 AGENT_DEPLOYED_IMMUTABLE)Klicken Sie auf New version, bearbeiten Sie den Entwurf und veröffentlichen Sie ihn.
Validierung: system prompt is required oder model configuration is requiredFüllen Sie den Abschnitt „Aufforderung“ aus oder wählen Sie ein Modell im Abschnitt „Modell“ aus.
Im Abschnitt „Modell“ steht „Keine Modelle konfiguriert.“ oder „Kein Schlüssel“.Registrieren Sie das Modell und seinen Schlüssel unter Tiet · Agentic → Agents → Models.
Invoke gibt 400 message or attachments required zurück.Der Körper enthält keine message.
Invoke gibt 403 Access denied oder Agent is not active zurück.Der Schlüssel gehört einer anderen Organisation, oder der Agent ist inaktiv (z. B. ein unberührtes Duplikat).
Invoke gibt 404 Agent not found zurück.Falsche Agenten-ID in der URL.
Eine Delegation schlägt fehl mit der Meldung "Unteragenten-Delegationslimit erreicht".Die Konversation hat ihre 30 Delegationen für die Stunde aufgebraucht. Starten Sie eine neue Konversation oder reduzieren Sie die Delegation.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..