Agent Studio

Agent Studio organizes agent and workflow definitions into projects. Teams can edit drafts, preserve immutable versions, and restore earlier definition behavior and source.

Projects, definitions and versions

A project holds shared source files. A definition selects its entrypoint and behavior. Creating a version captures the selected definition together with a project source snapshot. Restoring source can affect other definitions sharing that project, so review the draft before creating the next version.

Availability

The authoring service implements project and definition management, draft editing, version creation and restoration. Building executable artifacts and publishing agents have additional rollout dependencies. Confirm those capabilities separately with your administrator before planning an executable deployment.

Quickstart — list your projects

This read requires an enabled Studio API, an API-audience bearer token with the agent-studio:read role, fresh level-two authentication assurance, and a trusted organization binding. The organization header selects that binding and must match the caller’s authorized tenant.

Run this from a trusted developer environment. Set STUDIO_API_ORIGIN to the supplied HTTPS API origin, ORGANIZATION_ID to your authorized organization and STUDIO_ACCESS_TOKEN through your credential manager. Keep the token out of source control and command logs.

curl --fail-with-body "$STUDIO_API_ORIGIN/primero.agents.v1.StudioService/ListProjects" \
  -H "Authorization: Bearer $STUDIO_ACCESS_TOKEN" \
  -H "X-Organization-Id: $ORGANIZATION_ID" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  --data '{"pageSize":20}'

An empty successful response can be {"projects":[]}. This confirms that the read succeeded for the supplied context. Projects become visible after creation within that organization.

Errors and next steps

Check the token audience, read role, authentication assurance and organization binding if the request is denied. Confirm the API origin and enabled service if the route is unavailable. Use project creation and versioning once the installation has granted the corresponding authoring permissions.