- Vue d'ensemble (Overview)
- Démarrer
- Concepts
- Utilisation de la UiPath CLI
- Guides pratiques
- Revenus CI/CD
- Référence de commande
- Vue d'ensemble (Overview)
- Codes de sortie
- Options globales
- agent codé uip
- encodeur UIP
- uip ancrage dans le contexte
- UiPath Docsai
- Fonction UiP
- garde-fous UiP
- configuration llm uip
- uip llm-passerelle
- Création uip maestro
- Registre Maestro uip
- uip model-hub
- Tâches (Jobs)
- Dossiers
- Processus
- ROI du processus
- Paquets
- Machines
- Utilisateurs
- Rôles
- Licences
- Flux
- Pièces jointes (Attachments)
- Sessions
- Calendriers
- magasins d'informations d’identification
- journaux-audit
- paramètres
- Actifs
- Compartiments
- Compartiment-fichiers
- Bibliothèques
- Files d'attente (Queues)
- ROI de la file d'attente
- éléments de la file d'attente
- Déclencheurs (Triggers)
- Webhooks
- Activités - Rechercher
- activités get-Default-xaml
- Analyser
- liste règles-analyseurs
- Construire
- Nettoyage
- Installation de entités data-fabrics
- liste des entités data-fabrics
- Diff de fichiers
- Get-Library-Object-Repository
- Récupérer le référentiel d'objets
- Init
- liste des instances
- Créer un package
- Vérification des paquets
- Installation des paquets
- Versions de paquets
- Publier
- Distant
- restore
- exécuter, déboguer et amp; Exécution
- paramètres
- Début de Studio
- Recherche de modèles
- entité ajoutée aux données de test
- Ajouter une file d'attente de données de test
- variation d'ajout de données de test
- TM
- UIA
- Valider
- exemples de workflow - Obtenir
- liste d'exemples de workflow
- tâches UIP
- pièce jointe
- Champ personnalisé
- Défauts (Defects)
- Exécutions
- exporter-tâches
- Migration
- Libellé Objet
- Créer un package
- scénarios-perf
- groupes-de-charge-scénarios-perf
- données d’exécution de perf-scenario
- rapport de scénarios de performances
- Projet
- autorisations-projet
- Invites
- Rapport
- Prérequis
- Résultat
- Exécuter
- Planifications (Schedules)
- Journaux de cas de test
- Cas de test
- Ensembles de tests
- Journal des étapes de test
- Utilisateur (User)
- Attendre
- Traçages UIP
- Commentaires sur les traces UIP
- Migration
- Référence et assistance
débogage d’agent uip
Exécutez un agent low-code sur Studio Web avec des exemples d'entrées et diffuser le résultat avec `uip agent debug`.
uip agent debug exécute un agent low-code de bout en bout sur Studio Web avec les entrées que vous fournissez, en vous interrogeant jusqu'à ce que l'exécution se termine et que l'état du flux change. Nécessite une connexion.
Le projet doit utiliser un manifeste project.uiproj — un projet encore sur l'ancienne mise en page project.json échoue rapidement avec des instructions de conversion (les commandes de packaging comme uip solution pack/publish acceptent toujours project.json; seules les commandes liées à Studio-Web comme celui-ci nécessite le nouveau manifeste).
Synthèse
uip agent debug <project-path> [-i <json>] [--attachment <field=path>]... [--poll-interval <ms>] [--timeout <seconds>] [--login-validity <minutes>]
uip agent debug <project-path> [-i <json>] [--attachment <field=path>]... [--poll-interval <ms>] [--timeout <seconds>] [--login-validity <minutes>]
Toutes les invocations respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.
Arguments
<project-path>(requis) : le chemin d'accès au répertoire du projet d'agent (contenuagent.json).
Options
| Drapeau | Default | Objectif |
|---|---|---|
-i, --inputs <json> | {} | Arguments d'entrée en tant qu'objet JSON, par exemple '{"input":"hello"}'. Doit analyser en tant qu’objet simple. Pour un champ de pièce jointe de tâche, transmettez une référence de pièce jointe Orchestrator existante, {"ID": "<attachment-id>"}, ou utilisez --attachment pour télécharger un fichier local. |
--attachment <field=path> | — | Téléchargez un fichier local dans un champ d'entrée de pièce jointe de tâche de agent.json. Répétable. Le champ doit être déclaré comme {"$ref": "#/definitions/job-attachment"} dans inputSchema. Répétez le même champ uniquement lorsque son schéma est un tableau de pièces jointes de tâche. Le chemin se résout à partir du répertoire de travail actuel, et non à partir du répertoire de projet d’agent. Les ID de pièce jointe téléchargées sont renvoyés dans Data.Attachments. |
--poll-interval <ms> | 2000 | Intervalle d'interrogation en millisecondes. |
--timeout <seconds> | 600 secondes (10 minutes) | Nombre maximal de secondes à attendre de la fin de l'exécution. |
--login-validity <minutes> | 10 | Nombre minimum de minutes restants avant l’expiration du jeton requis pour continuer. |
Exemples
uip agent debug ./my-agent -i '{"input":"hello"}'
uip agent debug ./my-agent --timeout 120 --poll-interval 5000
# Upload a local PDF into the job-attachment input field fileIn
uip agent debug ./my-agent --attachment fileIn=./invoice.pdf -i '{"question":"What is the total?"}'
uip agent debug ./my-agent -i '{"input":"hello"}'
uip agent debug ./my-agent --timeout 120 --poll-interval 5000
# Upload a local PDF into the job-attachment input field fileIn
uip agent debug ./my-agent --attachment fileIn=./invoice.pdf -i '{"question":"What is the total?"}'
An --attachment value for a field also present in --inputs overrides the --inputs value, and the command logs a warning. A required job-attachment input that has neither an --attachment nor an --inputs value also produces a warning.
Format des données (--sortie json)
Réussite (Code: "AgentDebug"):
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "content": "hi there" }
},
"Instructions": "Debug run completed: Successful"
}
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "content": "hi there" }
},
"Instructions": "Debug run completed: Successful"
}
Output est présent uniquement lorsque l'exécution en a produit une; Info est présent uniquement lorsque le service renvoie des informations de diagnostic supplémentaires.
Lorsque l’exécution télécharge des fichiers avec --attachment, Data.Attachments répertorie chaque téléchargement:
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "answer": "1,234.00 USD" },
"Attachments": [
{
"Field": "fileIn",
"AttachmentId": "c3d4e5f6-0000-0000-0000-000000000002",
"FileName": "invoice.pdf",
"MimeType": "application/pdf",
"Size": 48213
}
]
}
}
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "answer": "1,234.00 USD" },
"Attachments": [
{
"Field": "fileIn",
"AttachmentId": "c3d4e5f6-0000-0000-0000-000000000002",
"FileName": "invoice.pdf",
"MimeType": "application/pdf",
"Size": 48213
}
]
}
}
To reuse an uploaded file in a later run without uploading it again, pass its reference in --inputs, for example '{"fileIn":{"ID":"c3d4e5f6-0000-0000-0000-000000000002"}}'.
Erreurs de pièce jointe : une valeur --attachment non valide (format field=path incorrect, un champ qui n'est pas une entrée de pièce jointe à la tâche, un chemin d'accès manquant, vide ou de répertoire) échoue avant que tout ce soit téléchargé ou exécuté, avec Retry: "RetryWillNotFix" Lorsque Orchestrator refuse un téléchargement, aucune tâche de débogage ne démarre.
État terminal non réussi — même Code: "AgentDebug", mais renvoyé comme un échec (code de sortie 1) avec Message: "Debug run <state>." et Instructions pointant sur uip traces spans get <TraceId> pour inspecter l'exécution.
Manifest de projet incompatible:
{
"Result": "Failure",
"ErrorCode": "invalid_argument",
"Message": "...",
"Instructions": "Convert the listed project(s) to a project.uiproj manifest before debugging: scaffold the accepted layout with 'uip api-workflow init <name>' inside the solution and move Workflow.json (plus entry-points.json and bindings_v2.json) into it, then remove the project.json-based entry from the .uipx. Note that 'uip solution pack' and 'uip solution publish' accept project.json — only Studio Web-bound commands require project.uiproj."
}
{
"Result": "Failure",
"ErrorCode": "invalid_argument",
"Message": "...",
"Instructions": "Convert the listed project(s) to a project.uiproj manifest before debugging: scaffold the accepted layout with 'uip api-workflow init <name>' inside the solution and move Workflow.json (plus entry-points.json and bindings_v2.json) into it, then remove the project.json-based entry from the .uipx. Note that 'uip solution pack' and 'uip solution publish' accept project.json — only Studio Web-bound commands require project.uiproj."
}
Associé
uip agent validate— Exécutez d'abord pour confirmer que le projet est bien formé; suggéré dans les instructions d'échec de téléchargement.uip traces spans get— inspecter la trace d'une exécution de Debug après un état non réussi.