Rat Things documentation

Choose the path
you need.

Start with a product overview, deploy to AWS, connect an agent to an existing deployment, or embed the API. Deeper operator and agent reference stays available when the task needs it.

Choose a documentation path

Try it locallyUse a trusted ChatGPT sign-in on your own device. Deploy the backendRun the bounded AWS golden path and retain evidence. Connect an agentDiscover an installed deployment from one URL. Embed Rat ThingsPut the owner-scoped API behind your own product UX.

Core concepts

Schedules and provider Sessions Schedule owned Agents and bind signed provider events to durable Sessions. Integrations, accounts, and permissions Connect and verify accounts, choose grants, and understand the effective permission intersection. The capability envelope Learn what an agent can use autonomously and what remains unavailable throughout Session execution. Durable work with Sessions Use durable Sessions and saved Turns from the console and CLI.

Use capabilities

Browser capabilities Browser automation for an Agent must be supplied through a declared function or MCP tool and enforced by the deployment's fixed capability policy. Creating a standard Session does… Durable files and Session Artifacts The standard Files API stores uploaded input. Session Artifacts retain immutable output from completed managed-environment Turns. Both belong to the authenticated owner and keep c… Publish and share agent work Create a publication from saved Session Artifacts to give recipients an expiring link to a file, static site or video. Publication delivery must be configured on the deployment; s… Publications: files, sites, and video Publications give retained files, static sites, and videos expiring browser access while S3 stays private. This page covers the contract and deployment; use publish and share agen…

Connect channels and events

Use Rat Things from Slack Start durable work from a Slack mention, continue in its thread, search or act through approved accounts, and understand current boundaries. Connect Rat Things to Linear Install a verified Linear workspace, expose bounded issue and comment operations, and run a Slack-to-Linear handoff. Connect a GitHub webhook A signed GitHub event starts a Session only when it matches an owned Agent/environment binding. Rat Things keeps webhook verification, repository checkout and terminal Turn notifi… Connect Rat Things to Microsoft Teams Rat Things separates the immediate Teams acknowledgement from the potentially long-running agent job: Channel adapters Channel integrations authenticate external events, resolve an owned Agent and environment through a source binding, and submit input to a Session. They share the same validation a…

Operate

Development and deployment This is the host/operator path for installing and maintaining an independent Rat Things deployment. Consumers of an existing deployment should start with the operating model inste… Diagnostics for consumers and operators Rat Things adds durable state and isolated execution so failures can be inspected rather than lost. The debugging contract is part of the product: use machine-readable discovery,… Operational runbook This runbook assumes an operator with read access to the runtime stack, CloudWatch Logs/Metrics, DynamoDB run records, SQS, S3 metadata, and Lambda MicroVM APIs. Use a separately… Cost model Rat Things runs the API, harness, storage and execution in your AWS account. Model usage and AWS infrastructure are separate costs. A connected Session worker remains available be…

Reference

Control API reference Use the Agents API for Agent, Session, Turn, Item, environment, Vault, File, Skill and Artifact operations. The official SDK uses the deployment's Agents endpoint, including live… Architecture Rat Things implements the OpenAI Agents API in infrastructure you own. The API, agent harness, Session coordination, encrypted storage, execution environments and executor relay r… Security and threat model Treat prompts, webhook fields, repositories, tool results and model output as untrusted. A valid provider signature authenticates the delivery; it does not make its author or cont… Capabilities and boundaries Understand the implemented systems, their current boundaries, and the next areas of development.