# AlphaAgent Docs > Public documentation for AlphaAgent: introduction, installation, the Studio guide, programmatic access, the Organisations guide, platform internals, reference, and migrating from other tools. This file contains links to documentation sections following the llmstxt.org standard. ## Table of Contents - [What is AlphaAgent](https://docs.alphaagent.prometheusrl.com/index.md): AlphaAgent in one page: the four products (Studio, Organisations, the Console and the REST API), where each runs, the standard or governed choice, ... - [Key concepts](https://docs.alphaagent.prometheusrl.com/introduction/key-concepts.md): The whole system in one diagram, then one short section on each term: Organisation, deployment, release and Update Manager, licence and metering, i... - [Connect your agent](https://docs.alphaagent.prometheusrl.com/introduction/connect-your-agent.md): Give an AlphaAgent Studio agent, Claude, ChatGPT or Cursor read access to these docs over MCP, with paste-ready configuration for each. - [Before you start](https://docs.alphaagent.prometheusrl.com/installation/before-you-start.md): What to have ready before you install AlphaAgent: fresh AWS accounts, hostnames and certificates, DNS, an Entra ID tenant, a workstation, IAM permi... - [Console account, offer and licence](https://docs.alphaagent.prometheusrl.com/installation/console-account-offer-and-licence.md): Create your AlphaAgent Console account, request and accept the private offer on AWS Marketplace, link the subscription to the Console, and create o... - [Install Organisations](https://docs.alphaagent.prometheusrl.com/installation/install-organisations.md): Download the Organisations bundle, run the guided orgctl.py installer, answer its questions, follow the twelve checkpointed steps including the con... - [Sign in to the Organisations console with Entra ID](https://docs.alphaagent.prometheusrl.com/installation/sign-in-with-entra-id.md): Create the SAML enterprise application from the values the installer prints, hand its federation metadata to the saml step, and sign in to the Orga... - [Connect your Entra ID tenant for Studio sign-in (SSO)](https://docs.alphaagent.prometheusrl.com/installation/connect-your-identity-provider.md): The second Entra ID set-up: a multi-tenant app registration with five Microsoft Graph application permissions and admin consent, connected once on ... - [Register an AWS account](https://docs.alphaagent.prometheusrl.com/installation/register-an-aws-account.md): Register a fresh AWS account for a Studio deployment in the Organisations console, run the target-account role template in that account, and Verify... - [Deploy your first Studio](https://docs.alphaagent.prometheusrl.com/installation/deploy-your-first-studio.md): Choose standard or governed, fill in the New deployment wizard, run preflight, launch, watch the fourteen-step install job (45 to 50 minutes), and ... - [After the deploy: users, roles and libraries](https://docs.alphaagent.prometheusrl.com/installation/after-the-deploy.md): Let the first users in: assign the StudioUser role for the deployment from Identity & Access Management, check who can sign in, create a typed libr... - [Troubleshooting the install](https://docs.alphaagent.prometheusrl.com/installation/troubleshooting-the-install.md): What to do when a step stops: installer exit codes and FATAL lines, preflight remediations, the Resume menu, state file and lock, settle and DNS, t... - [Getting started](https://docs.alphaagent.prometheusrl.com/studio-guide/getting-started.md): Sign in to Studio with your company login, find the dock and the sidebar, tell a standard deployment from a governed one, read your profile and sig... - [Chat](https://docs.alphaagent.prometheusrl.com/studio-guide/chat.md): Start a conversation with an active agent, manage it from its header, and find the pages on the board, mentions, files, approvals and turning a cha... - [Chat: the board and mentions](https://docs.alphaagent.prometheusrl.com/studio-guide/chat-the-board-and-mentions.md): How a message runs on the board: card states, the inspector, @ mentions of steps, agents, files and teammates, sending more while a run works, Stop... - [Chat: files, previews and approvals](https://docs.alphaagent.prometheusrl.com/studio-guide/chat-files-previews-and-approvals.md): Upload files and zips, browse your workspace, preview outputs, read deliverable cards, approve a step on its card, and read the timeline, read rece... - [Chat: turn a conversation into a workflow](https://docs.alphaagent.prometheusrl.com/studio-guide/chat-turn-a-conversation-into-a-workflow.md): Ask the agent in the composer to turn a conversation into a workflow, open the WORKFLOW CREATED tile in the builder, and check and activate the res... - [Agents](https://docs.alphaagent.prometheusrl.com/studio-guide/agents.md): What an agent is in Studio, specialists and supervisors, the Manage Agents list, and where to create, configure and download agents. - [Agents: create and optimise](https://docs.alphaagent.prometheusrl.com/studio-guide/agents-create-and-optimise.md): Create an agent from a name, type, description and system prompt, save the prompt as written or optimised, read the view page, and publish new vers... - [Agents: configure and activate](https://docs.alphaagent.prometheusrl.com/studio-guide/agents-configure-and-activate.md): The Agent Map Configure dialog: add data connectors and pick their versions, pin a Ready knowledge graph version, set the execution environment, Sa... - [Agent Store](https://docs.alphaagent.prometheusrl.com/studio-guide/agent-store.md): Browse the curated agents published by Prometheus Research Labs and download a copy into your own Agents; the copy arrives Inactive and needs wirin... - [Knowledge graphs](https://docs.alphaagent.prometheusrl.com/studio-guide/knowledge-graphs.md): Knowledge graphs (AMPGs) your agents ground their answers in: how versions work, the list and the storage line, and where to build, pin, move and d... - [Knowledge graphs: build a version](https://docs.alphaagent.prometheusrl.com/studio-guide/knowledge-graphs-build-a-version.md): Build a knowledge graph version from one PDF: the upload limits and their messages, the six-step build rail, the live log, leaving the page, cancel... - [Knowledge graphs: use, move agents, delete](https://docs.alphaagent.prometheusrl.com/studio-guide/knowledge-graphs-use-move-agents-delete.md): The graph page, its Versions table and Stats: see which agents pin which version, move them to another version in one action, share a Ready version... - [Data connectors](https://docs.alphaagent.prometheusrl.com/studio-guide/data-connectors.md): What a data connector is, the five types and when to use each, the fields every connector shares, statuses and limits. - [SQL connectors: PostgreSQL and MySQL](https://docs.alphaagent.prometheusrl.com/studio-guide/sql-connectors.md): Connect Studio to a PostgreSQL or MySQL database: the fields, network and TLS prerequisites, Test Connection, schema exploration, and the read-only... - [Snowflake connector](https://docs.alphaagent.prometheusrl.com/studio-guide/snowflake-connector.md): Connect Studio to Snowflake as a service user with a programmatic access token or an RSA key pair: the fields, the network policy for the deploymen... - [REST / OpenAPI connector](https://docs.alphaagent.prometheusrl.com/studio-guide/rest-openapi-connector.md): Connect a REST API: the base URL, the OpenAPI specification (up to 8 MiB), Validate OpenAPI, the enriched guide, credentials as headers or query pa... - [MCP connector](https://docs.alphaagent.prometheusrl.com/studio-guide/mcp-connector.md): Add an MCP server as a data connector: the server URL over streamable HTTP, optional credentials, Test Connection, tool discovery into the guide, a... - [AWS connector](https://docs.alphaagent.prometheusrl.com/studio-guide/aws-connector.md): Connect an AWS account through an IAM role you create with a Studio-generated External ID: the platform principal and trust policy, Test connection... - [Connector versions, Test Connection and guides](https://docs.alphaagent.prometheusrl.com/studio-guide/connector-versions-test-connection-and-guides.md): The connector detail page and Update form: every save creates a new version, the versions table, credential rotation per type, Test Connection and ... - [Execution environments](https://docs.alphaagent.prometheusrl.com/studio-guide/execution-environments.md): Sandboxed Linux containers your agents run code in: prebuilt or custom image, provisioning and status, timeouts, the working directory, the Environ... - [Workflows](https://docs.alphaagent.prometheusrl.com/studio-guide/workflows.md): What a workflow is, the five step types, the build, version, activate and run lifecycle, and where each workflow task is documented. - [Workflows: build](https://docs.alphaagent.prometheusrl.com/studio-guide/workflows-build.md): Build a workflow on the board: add and configure the five step types, wire them, set parameters and run settings, save as a new version, activate, ... - [Workflows: run, schedule, approve](https://docs.alphaagent.prometheusrl.com/studio-guide/workflows-run-schedule-approve.md): Run a workflow with parameters, schedule it, read the runs list and the run page, approve, send back or stop a waiting step, and read why a run fai... - [Workflows: the knowledge-graph update node](https://docs.alphaagent.prometheusrl.com/studio-guide/workflows-knowledge-graph-update-node.md): Train the next knowledge-graph version from a workflow with the AMPG update step: Rewrite or Append, always from the newest Ready version, the revi... - [Workflows: trigger from outside](https://docs.alphaagent.prometheusrl.com/studio-guide/workflows-trigger-from-outside.md): Governed deployments expose active workflows over the REST API; where to read how to trigger a workflow run from an external system. - [Libraries and sharing](https://docs.alphaagent.prometheusrl.com/studio-guide/libraries-and-sharing.md): Share a resource version to a Library, follow the request in the Shared to strip, browse the Libraries you belong to, download a copy, update your ... - [Inbox](https://docs.alphaagent.prometheusrl.com/studio-guide/inbox.md): Completed, failed and cancelled runs, approvals waiting for you, publish cards, and the dock badge. - [The Governor](https://docs.alphaagent.prometheusrl.com/studio-guide/governor.md): What the Governor does to a run and how you see it: the badge, the popover labels, checkpoints every four tool calls, at most three steers, never i... - [PII redaction](https://docs.alphaagent.prometheusrl.com/studio-guide/pii-redaction.md): Where PII redaction is set in Studio, the governed default as a floor, the modes, categories and stages, the Redact PII step, and the markers you s... - [Working in a governed deployment](https://docs.alphaagent.prometheusrl.com/studio-guide/working-in-a-governed-deployment.md): In a governed deployment everything is shared: how to recognise one, what you see and can change, whose files you can open, where your writes go, a... - [Banners you may see](https://docs.alphaagent.prometheusrl.com/studio-guide/banners-you-may-see.md): What each banner at the top of Studio means and what to do: Amazon Bedrock throttling, updates, licence and billing notices, an expired session, an... - [Overview](https://docs.alphaagent.prometheusrl.com/programmatic-access/overview.md): The REST API on governed deployments: what it can do, why a standard deployment answers 503, and who creates keys. - [API keys](https://docs.alphaagent.prometheusrl.com/programmatic-access/api-keys.md): What an API key is for the caller: the deployment, workflows, scopes, IP allow-list, allowed hours and expiry it carries, the two credentials shown... - [Authentication](https://docs.alphaagent.prometheusrl.com/programmatic-access/authentication.md): Authenticate with the bearer key and the External-Id header, know which API version you are calling, and read the 401 and 403 responses. - [Run a workflow from your system](https://docs.alphaagent.prometheusrl.com/programmatic-access/run-a-workflow-from-your-system.md): List workflows, read a workflow's parameters, start a run, poll its status and steps, fetch outputs, cancel, and erase run data, in curl and Python. - [Patterns](https://docs.alphaagent.prometheusrl.com/programmatic-access/patterns.md): Two end-to-end patterns for the API: files your system drops in S3 are picked up by a workflow through the AWS connector, and an API-triggered run ... - [Limits, errors and codes](https://docs.alphaagent.prometheusrl.com/programmatic-access/limits-errors-and-codes.md): Rate limits and quotas, Retry-After, the error envelope, every status code and error code, and the OpenAPI file. - [The console: layout and roles](https://docs.alphaagent.prometheusrl.com/organisations-guide/the-console-layout-and-roles.md): How the Organisations console is laid out, what Home shows, and how the Owner, Operator and Viewer tiers and the built-in Roles decide what each ad... - [Fleet](https://docs.alphaagent.prometheusrl.com/organisations-guide/fleet.md): The Fleet list: search and filters, columns, health values, version wording, per-row actions and paging. - [Deployment detail](https://docs.alphaagent.prometheusrl.com/organisations-guide/deployment-detail.md): A deployment's Overview, Configuration, Identity, Endpoints and Health and Analytics views: retention, the DNS target and front door, the SAML runb... - [Jobs, progress and failures](https://docs.alphaagent.prometheusrl.com/organisations-guide/jobs-progress-and-failures.md): Read a deployment's jobs: the list and filters, the live step timeline and logs, parked steps and how to answer them, failure cards, and Resume, Re... - [Fleet configurations and Update Manager](https://docs.alphaagent.prometheusrl.com/organisations-guide/fleet-configurations-and-update-manager.md): Update Studio with a Fleet Configuration Template and an Update Manager rule: the template fields, the rule's targets, schedule and maintenance win... - [Accounts](https://docs.alphaagent.prometheusrl.com/organisations-guide/accounts.md): Register, verify, inspect, clear and remove the AWS accounts your Studio deployments run in. - [Identity providers (Entra ID)](https://docs.alphaagent.prometheusrl.com/organisations-guide/identity-providers.md): Set up Microsoft Entra ID for Studio single sign-on: connect, inspect and remove tenants, and manage the shared application credential and its expiry. - [Users, groups and roles](https://docs.alphaagent.prometheusrl.com/organisations-guide/users-groups-and-roles.md): Who can use what: assign StudioUser per deployment from the Users directory, grant Roles to groups, read a person's detail, the Admins roster, and ... - [Libraries](https://docs.alphaagent.prometheusrl.com/organisations-guide/libraries.md): Create a typed Library, add Readers and Contributors on its Members tab, push items and read their versions and the Activity log of every share and... - [Programmatic access](https://docs.alphaagent.prometheusrl.com/organisations-guide/programmatic-access.md): Mint, edit, rotate and revoke API keys bound to one governed deployment, copy the two credentials shown once, and read a key's usage and audit trail. - [Audit](https://docs.alphaagent.prometheusrl.com/organisations-guide/audit.md): What the Organisations audit log records, how to filter it, and how to keep a copy. - [Deleting a deployment and clearing an account](https://docs.alphaagent.prometheusrl.com/organisations-guide/deleting-a-deployment-and-clearing-an-account.md): Delete a deployment, cancel during the grace window, read the teardown report, clear the account and verify it, and remove what stays yours. - [Console: licences, usage and billing](https://docs.alphaagent.prometheusrl.com/organisations-guide/console-licences-usage-and-billing.md): The AlphaAgent Console pages an administrator keeps using: licence keys and their states, consumption and usage, AWS Marketplace billing and statem... - [Upgrading Organisations](https://docs.alphaagent.prometheusrl.com/organisations-guide/upgrading-organisations.md): Upgrade Organisations from a new bundle: the Resume menu, which steps re-run, how the installer reads the running version, the doctor's rollout wai... - [Architecture overview](https://docs.alphaagent.prometheusrl.com/platform-internals/architecture-overview.md): The account picture: the AlphaAgent Console, your Organisations account and your Studio accounts, what talks to what and in which direction. - [What runs in your account (Studio)](https://docs.alphaagent.prometheusrl.com/platform-internals/what-runs-in-your-account-studio.md): Every component a Studio deployment runs in your account, from the CloudFront front door to the sandboxes and data stores, with a resource inventor... - [What runs in your account (Organisations)](https://docs.alphaagent.prometheusrl.com/platform-internals/what-runs-in-your-account-organisations.md): What the Organisations account runs: the engine, the cross-account role and External ID model, the registration template's permissions, staging buc... - [What leaves your account](https://docs.alphaagent.prometheusrl.com/platform-internals/what-leaves-your-account.md): The two flows that report on your deployment to us, the licence heartbeat and usage events, field by field; the fail-closed behaviour, signed respo... - [Identity and access](https://docs.alphaagent.prometheusrl.com/platform-internals/identity-and-access.md): Single sign-on end to end, the roles, per-user isolation in standard deployments, and the governed model of shared resources. - [Sandbox isolation](https://docs.alphaagent.prometheusrl.com/platform-internals/sandbox-isolation.md): How agent code is isolated: one execution per user scope, a clean environment, scoped short-lived credentials, and what code can and cannot reach. - [Secrets and connector credentials](https://docs.alphaagent.prometheusrl.com/platform-internals/secrets-and-connector-credentials.md): Where connector credentials live, how they reach the sandbox only at invocation, the AWS connector's customer-owned role, and what sharing relays. - [Data at rest and in transit](https://docs.alphaagent.prometheusrl.com/platform-internals/data-at-rest-and-in-transit.md): Encryption at rest and in transit, retention and deletion including erasure through the API, and what is logged where and for how long. - [Audit trails](https://docs.alphaagent.prometheusrl.com/platform-internals/audit-trails.md): The audit trails across Organisations, the Console and Studio, what each records, how long it is kept, and how to get records out. - [Updates and rollback](https://docs.alphaagent.prometheusrl.com/platform-internals/updates-and-rollback.md): How updates roll out through Update Manager, what restarts and when users see the update screen, how rollback works, and how Organisations upgrades... - [PII redaction posture](https://docs.alphaagent.prometheusrl.com/platform-internals/pii-redaction-posture.md): Where PII redaction runs, what it protects, and what it does not claim. - [Shared responsibility and best practices](https://docs.alphaagent.prometheusrl.com/platform-internals/shared-responsibility-and-best-practices.md): What we are responsible for and what you are, with the practices we recommend for your accounts, identity, network, keys, backups and cost alarms. - [Threat model summary](https://docs.alphaagent.prometheusrl.com/platform-internals/threat-model-summary.md): What the design protects against and by which mechanism, and what it does not protect against. - [The Console side: what Prometheus Research Labs holds and where](https://docs.alphaagent.prometheusrl.com/platform-internals/the-console-side.md): What Prometheus Research Labs holds about you on the Console side, where, for how long, who can see it, the sub-processors, and how to request dele... - [How agents run code](https://docs.alphaagent.prometheusrl.com/platform-internals/how-agents-run-code.md): How an agent runs real code in a sandboxed execution environment, where its workspace and outputs live, how users are isolated from each other, and... - [Knowledge graphs in depth](https://docs.alphaagent.prometheusrl.com/platform-internals/knowledge-graphs-in-depth.md): How a knowledge graph (AMPG) is built from your documents and versioned, where each stage keeps your data, and how agents ground answers in a pinne... - [Everything AlphaAgent deploys](https://docs.alphaagent.prometheusrl.com/platform-internals/everything-alphaagent-deploys.md): Every CloudFormation stack and resource type AlphaAgent creates in your accounts, what is created outside CloudFormation, what Studio creates while... - [SCPs and guardrails that block installs](https://docs.alphaagent.prometheusrl.com/platform-internals/scps-and-guardrails.md): The nineteen service control policy and guardrail patterns that block an AlphaAgent install, the exact copy each one produces, the checklist to run... - [Limits and quotas](https://docs.alphaagent.prometheusrl.com/reference/limits-and-quotas.md): Every limit AlphaAgent enforces: what you can create in Studio and how large it can be, the caps in the Organisations console, the workflow API's p... - [Infrastructure sizing and costs](https://docs.alphaagent.prometheusrl.com/reference/infrastructure-sizing-and-costs.md): What AlphaAgent Studio provisions in your AWS account, the five sizing tiers and the Redis node type, how long a deployment and a knowledge-graph b... - [Supported models](https://docs.alphaagent.prometheusrl.com/reference/supported-models.md): The Amazon Bedrock models Studio 2.0.14 offers for the runner and planner, the fixed embeddings model, the redactor, the defaults, how the inferenc... - [Failure codes](https://docs.alphaagent.prometheusrl.com/reference/failure-codes.md): Every failure code AlphaAgent can show you: the Organisations job failure codes on a deployment's failure card, grouped by who acts and whether Res... - [FAQ](https://docs.alphaagent.prometheusrl.com/reference/faq.md): Short answers to the questions Studio users ask most: the 256-per-type cap, PDF limits for knowledge graphs, an environment that needs attention, a... - [Troubleshooting](https://docs.alphaagent.prometheusrl.com/reference/troubleshooting.md): What to do when AlphaAgent refuses or stops: install refusals by preflight check, orgctl.py exit codes and fatal messages, account Verify failures,... - [Glossary](https://docs.alphaagent.prometheusrl.com/reference/glossary.md): Every term used across the AlphaAgent Console, AlphaAgent Organisations and AlphaAgent Studio, defined in one or two sentences with a link to the p... - [Support](https://docs.alphaagent.prometheusrl.com/support.md): How to reach AlphaAgent support at hello@prometheusrl.com and what to include so the first reply can help: Organisation, deployment id, Diagnostic ... - [Bring your Claude skills and memories](https://docs.alphaagent.prometheusrl.com/migrate/bring-your-claude-skills-and-memories.md): What each Claude Desktop or Claude Code skill, memory, CLAUDE.md file, sub-agent and MCP server becomes in AlphaAgent Studio, the six steps of a mi...