By name: preset-cortex-agents description: Use Snowflake Cortex Agent REST and SQL APIs for listing, describing, creating, updating, deleting, running agents, streaming responses, and SQL wrappers. Use only for direct API workflows; Do not use for MCP-only work.
preset-cortex-agents
Use for Snowflake Cortex Agent object management and run workflows.
Always
- Account, auth, role, warehouse, database/schema, privilege, and safety context comes from
preset-snowflake-cortex; consult it when that context is missing. - Prefer read-only list/describe before mutations.
- Require confirmation of query, role, tools, budget, and output handling before any run.
- Require rollback planning before create, update, replace, or delete.
- Treat streamed events as sensitive; store redacted summaries unless raw output handling is approved.
- Do not rely on pre-2025 Cortex Agent schemas.
Decision Rules
- Distinguish list and describe from run, create, update, and drop operations.
- Require approval for data-returning agent runs and mutations.
- Preserve streaming output handling and redaction.
- Require AUTOCOMMIT for SQL DDL workflows.
Workflow Order
- Verify Snowflake Cortex account, auth, role, warehouse, database, schema, and privilege context.
- List or describe agents first.
- Prepare run or mutation approval summary with tools, query, budget, and output handling.
- Stop before run, create, update, replace, or drop until approved.
Retrieve
- Object-based or ad hoc
agent:run: references/agent-runs.md - List/describe/create/update/delete agents: references/agent-management.md
- SQL create/alter/show/describe/drop: references/sql-agent-ddl.md
SNOWFLAKE.CORTEX.DATA_AGENT_RUNSQL wrapper: references/sql-wrapper.md- Safety and approval checklist: load
preset-snowflake-cortexand thenreferences/cortex-safety.md.