Key Concepts
An organization has projects. A project holds an agent's files in Git, its tools, its triggers, its runs and the people who can change it.
Organization
People
Users, groups, SSO and organization settings
Projects
One for each team, with its own members and roles
in each project
Who starts a run
A person
Web app, Assistant or CLI
A trigger
An event, a schedule or a set time
starts
Project
Git repository
Agents and skills, one commit for each change
agents/pr-review/agent.yamlskills/review-rules/SKILL.mdIntegration Connections
Tools, and the sign-in for CLIs in the sandbox
GitHubSlackCustom MCPthe agent and its tools
Run
Transcript, result and artifacts
A run reads the agent's files from the project's Git repository. It gets its tools from the project's Integration Connections. A person or a trigger starts it. A second team gets its own project, and it can import an Integration Connection that another project shares.
Where things are in the app
The column at the left edge of the app has four zones, the Assistant and the settings. All of them show the project that you select in the project picker.
| Tile | Zone | What you do there | What it has |
|---|---|---|---|
| Work | Work | Run agents and see what they found | My work, Runs, Artifacts, Alerts |
| Agents | Agent Studio | Build, test and change agents | The branch button, Agents, Skills, Templates, Editor, Triggers |
| Context | Context Graph | Describe your systems, and review what agents learned | Graph, Memories, and the setup pages Sources, Blueprints and Labels |
| Insights | Insights | See how your agents are doing | Runs, estimated spend and token use |
| Assistant | Ask Autoheal to build, run or explain something | A panel that opens on every page | |
| Settings | Set up the project | Integrations, tools, agent policies, secrets and access |
The words used in these docs
| Word | What it is | Where you find it |
|---|---|---|
| Organization | Your company's Autoheal account: users, groups, SSO and org settings | Org settings |
| Project | A team's workspace. It has its own Git repository, Integration Connections, triggers and members. Every organization starts with a Default Project. | The project picker, at the top left |
| Agent | A folder agents/<id>/ with an agent.yaml file: instructions, model, tools and skills | Agent Studio → Agents |
| Skill | A folder skills/<id>/ with a SKILL.md file: know-how that an agent loads when it needs it | Agent Studio → Skills |
| Integration Connection | One connected system, such as a GitHub organization or a Grafana instance | Settings → Integrations |
| Tool | One action that an agent can do. System tools come with Autoheal. Integration tools come from Integration Connections. | The run transcript |
| Trigger | A rule: when this event occurs, run this agent with this prompt | Agent Studio → Triggers |
| Run | One execution of an agent, with its transcript and result | Runs |
| Artifact | A file that a run makes, such as a report | Artifacts |
| Branch | A separate line of changes in the project's repository. Use it to try a change before other people use it. | The branch button at the top of the Agent Studio sidebar |
Where an agent's behavior comes from
| The agent's... | Comes from | Change it in |
|---|---|---|
| Job and rules | instructions in agent.yaml, or a Markdown file it names | The editor, or autoheal agents push |
| Model | model in agent.yaml. If you leave it out, the organization's default model. | agent.yaml |
| Know-how | Skills in the project, or skills in the agent's own folder | skills/<id>/SKILL.md |
| Tools | System tools and the tools of the project's Integration Connections, limited by the system_tools and integration_tools filters. The shell, with CLIs such as gh signed in for the project's connections, is always available and filters do not limit it. | agent.yaml, and Settings → Integrations |
| Start | A person (web app, Assistant or CLI) or a trigger | Agent Studio → Triggers |
If you used Autoheal before
Incident response is now an agent, Incident Response, that you can read, run and change like every other agent. The steps you followed before are now its instructions and skills.