Merged
Conversation
DragosBobolea
changed the title
DragosBobolea
force-pushed
the
feature/context-grounding-cli
branch
2 times, most recently
from
355f426 to
8d819e6
Compare
DragosBobolea
changed the title
DragosBobolea
force-pushed
the
feature/context-grounding-cli
branch
from
8d819e6 to
1051a63
Compare
github-actions
Bot
added
test:uipath-langchain
DragosBobolea
force-pushed
the
feature/context-grounding-cli
branch
4 times, most recently
from
905d74e to
13ddb2f
Compare
andrei-rusu
approved these changes
Mar 30, 2026
Adds a new command group for working with Context Grounding (ECS) indexes directly from the terminal — the same semantic search agents use at runtime. Commands -------- uipath context-grounding list --folder-path PATH uipath context-grounding retrieve --index NAME --folder-path PATH uipath context-grounding search QUERY --index NAME --folder-path PATH uipath context-grounding ingest --index NAME --folder-path PATH uipath context-grounding delete --index NAME --folder-path PATH All commands accept --folder-path / --folder-key, --format [json|table|csv], and -o FILE, consistent with `uipath buckets` and `uipath assets`. search also accepts --limit (min 1, default 10) and --threshold (optional). Service changes (uipath-platform) ---------------------------------- - Add list() / list_async() to ContextGroundingService (GET /ecs_/v2/indexes without $filter; retrieve() uses the same endpoint with Name eq filter) - Replace bare list[T] annotations in the service with List[T] from typing to fix a class-scope shadowing issue: naming a method `list` causes Python to resolve the built-in as the method when evaluating later annotations - list and search table output projects to key columns; full objects for JSON/CSV CLI changes (uipath) -------------------- - Register `context-grounding` in _LAZY_COMMANDS with hyphen->underscore fix for getattr (context-grounding -> context_grounding) - --index named option on all commands that take an index name - --limit (min 1, default 10) and --threshold (optional float) for search - ingest and delete guard against index.id=None to avoid a silent SDK no-op - ingest fast-fails via index.in_progress_ingestion() before the HTTP call - Error handling mirrors cli_buckets.py: HTTPStatusError 404 and SDK bare Exception route through handle_not_found_error() - _handle_retrieve_error() typed -> NoReturn for correct control-flow inference - All exceptions from delete_index()/ingest_data() surface as ClickException Files ----- packages/uipath-platform/.../context_grounding/_context_grounding_service.py packages/uipath-platform/tests/services/test_context_grounding_service.py packages/uipath/src/uipath/_cli/__init__.py packages/uipath/src/uipath/_cli/services/__init__.py packages/uipath/src/uipath/_cli/services/cli_context_grounding.py (new) packages/uipath/tests/cli/contract/test_sdk_cli_alignment.py packages/uipath/tests/cli/integration/test_context_grounding_commands.py (new) Verified against alpha.uipath.com / goldenagents / DefaultTenant.
DragosBobolea
force-pushed
the
feature/context-grounding-cli
branch
from
13ddb2f to
b9a8409
Compare
pateljay43
added a commit
that referenced
this pull request
Mar 30, 2026
…upport, and full command coverage Rewrites the context-grounding CLI introduced in #1523 with: - All identifiers as explicit named options (--index-name, --index-id, --task-name, --task-id, --query, --output-file) — no ambiguous positionals - Dual index flow: --index-name + --folder-path for regular indexes, --index-id for ephemeral indexes - New commands: create, create-ephemeral, source-schema, deep-rag (start/retrieve), batch-transform (start/retrieve/download) - Uses unified_search (v1.2) instead of deprecated search method - Uses list_indexes instead of list (avoids shadowing builtin) - Uses convenience methods (ingest_by_name, delete_by_name) instead of two-step retrieve + operate pattern - SDK start_deep_rag/start_batch_transform accept both index_name and index_id natively — no branching needed in CLI - source-schema command generates JSON templates from Pydantic models at runtime - Updated contract tests (11 passing) and integration tests (47 passing) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add
uipath context-groundingCLI commandsSummary
Adds a new
uipath context-groundingcommand group to the CLI, giving developers direct access to the Context Grounding (ECS) service from the terminalCommands
All commands support
--folder-path,--folder-key,--format [json|table|csv], and-o <file>— consistent withuipath buckets.Examples
Verified against live environment
Tested against
https://alpha.uipath.com/goldenagents/DefaultTenant,Athena_Chatbotindex inSharedfolder: