Agent UIP

Élaborez, validez, actualisez, examinez et gérez les agents low-code à l’aide de l’outil « uip agent ».

uip agent est l'outil Agent: il élabore, valide, migre et examine les agents low-code — les projets pilotés par agent.jsoncréés dans Agent Builder/Studio Web. Installez-le avec uip tools install agent, ou invoquez uip agent … et laissez l'installation automatique s'exécuter. Voir Outils pour le modèle d'installation et Outils uip pour la commande qui gère l'installation de l'outil.

Cet outil est distinct de l'outil d'agent codé (uip codedagent), qui cible les agents Python créés avec les agents LangGraph/LlamaIndex/OpenAI. uip agent fonctionne uniquement sur les projets d'agent low-code: un répertoire contenant agent.json, entry-points.json, project.uiproj, une arborescence evals/ et des dossiers features/ / resources/ — ou, pour un agent intégré dans un Maestro Flow, un sous-répertoire nommé UUID à l'intérieur du projet de flux (--inline-in-flow).

uip agent n'a pas de pack, publish, deploy, push, pull, run, list, share, file, config, context, escalation, input ou output - compresser et expédier un projet d'agent passe par uip solution à la place (le projet d'agent est un projet à l'intérieur d'une solution). La création des ressources (outils, contextes, escalades, schéma I/O) s’effectue en modifiant manuellement agent.json, et non via un verbe CLI dédié.

Qu’est-ce qu’un agent UiPath?

Un agent low-code est décrit de manière déclarative par un seul fichier agent.json — modèle, invites, schémas d'entrée/sortie, outils, contextes, escalades et paramètres. Les fichiers d'assistance décrivent les points d'entrée que Studio Web utilise pour invoquer l'agent, l'ensemble d'évaluations par défaut et toutes les ressources RAG/HITL.

Le cycle de vie réel couvert par uip agent est:

1. Élaborez un projet sur le disque avec uip agent init (autonome, ou --inline-in-flow dans un projet Maestro Flow). Par défaut, le projet s'enregistre automatiquement dans le .uipx d'une solution voisine, ou un nouveau <Name>Solution est élaboré automatiquement lorsqu'il n'en existe pas non plus.
2. Création en modifiant à la main agent.json (et les fichiers sous resources/, evals/).
3. Actualisez le projet (uip agent refresh) après chaque modification — applique les migrations de schéma en attente et régénère entry-points.json / bindings_v2.json. Il s’agit de la seule commande qui écrit des fichiers dérivés.
4. Validez le projet (uip agent validate) — strict, en lecture seule: réponses « Studio Web accepterait-il ce répertoire tel quel?» sans écrire quoi que ce soit.
5. Examinez le projet au regard d'un ensemble de règles déterministes (uip agent review) pour obtenir un Statut de qualité marqué et enregistrez éventuellement la note au fil du temps (uip agent review-history add).
6. Configurez les modèles LLM (uip agent model list), les espaces de mémoire (uip agent memory), les garde-fous (uip agent guardrails) et les outils (uip agent tool list) selon vos besoins.
7. Déboguez l’agent avec Studio Web (uip agent debug) pour l’exécuter de bout en bout avec des exemples d’entrées avant l’expédition.
8. Livré avec uip solution pack / publish / upload / deploy — uip agent n'a pas de verbe d'empaquetage ou de déploiement propre.
9. Évaluez l'agent par rapport à un ensemble d'évaluation (uip agent eval run start) - fonctionne par rapport à une solution transmise au cloud (--solution-id, ou détectée automatiquement à partir de SolutionStorage.json) ou, lorsque ni l'un ou l'autre n'est disponible, un chemin d'évaluation implicite de l'espace de travail local.

Verbes

Commande	Objectif
Init	Élaborez un nouveau projet d’agent sur disque (autonome ou en ligne dans un projet de flux).
Valider	Vérification stricte en lecture seule: est-ce que Studio Web acceptera ce projet tel quel?
refresh	Appliquez les migrations de schéma en attente et régénérez entry-points.json / bindings_v2.json.
Révision	Attribuez une note au projet par rapport à un ensemble de règles déterministe (Version, score, note, problèmes).
historique-révision	Enregistrez une note de révision dans le fichier d'historique des révisions local du projet.
liste d’outils	Répertoriez les ressources d’outil configurées sur l’agent.
Mémoire	Associer, répertorier et supprimer des espaces de mémoire et des éléments de mémoire.
Évaluation	Gérez les évaluateurs, les ensembles d’évaluation, les cas de test et les exécutions d’évaluation.
Garde-fous	Répertoriez les définitions des garde-fous, les garde-fous BYOM, les modèles LLM en tant que juge et le catalogue de garde-fous.
model	Répertorie les modèles LLM disponibles pour le locataire authentifié.
Débogage	Exécutez l'agent dans Studio Web avec des exemples d'entrées et diffuser le résultat.

Synthèse

uip agent <verb> [subverb] [arguments] [options]

Toujours uip agent, jamais uip agents ou uip a. agent est le commandPrefix de l'outil (voir uip tools list).

Tous les verbes uip agent respectent les quatre options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat partagé.

Flux de bout en bout

# 1. Scaffold (auto-registers into the surrounding solution, or creates one)
uip agent init ./my-agent --model gpt-5.4

# 2. Refresh after any edit to agent.json (migrates + regenerates derived files)
uip agent refresh ./my-agent

# 3. Validate the project is ready for upload (strict, read-only)
uip agent validate ./my-agent

# 4. Review for quality issues before shipping
uip agent review ./my-agent

# 5. Ship via the solution the project was registered into
uip solution pack . ./dist
uip solution upload .

# 6. Evaluate (against the cloud project once pushed, or the local workspace)
uip agent eval run start --set default --path ./my-agent --wait

# 7. Debug a specific run against Studio Web
uip agent debug ./my-agent -i '{"input":"hello"}'

Authentification

debug, eval run *, guardrails llm-as-judge-models et model list appellent Studio Web/la passerelle LLM et nécessitent une session CLI active. Exécutez d'abord uip login. Voir Authentification pour le modèle de session.

init, validate, refresh, review, review-history, tool list, memory, guardrails list et guardrails catalog sont uniquement disponibles en local et ne nécessitent pas de session.

Voir également

• Concepts: outils (extensions) — le modèle de plug-in et l'épinglage de la version.
• uip solution — empaqueter, publier et déployer la solution dans laquelle réside un projet d'agent.
• Authentification — sessions, locataires et dossiers.
• Options globales, codes de sortie.