Quickstart
Connect a tool, run an agent in chat, then put it on a schedule - in about five minutes.
Quickstart
You'll connect a tool, get an agent to do a task in chat, then save that task as a workflow so it runs on its own.
Create a project
A project groups related agents, integrations, and variables - and decides who can reach them.
- Go to Projects and choose Create Project.
- Name it after the work, e.g. "engineering digests".
- Set its visibility: Organization so your team can use it, or Restricted to keep it to yourself.
You already have a Personal project if you'd rather just experiment.
Connect a tool
- Open Integrations and pick a service - GitHub is a good first one.
- Choose an authentication method. The Helios app is the fastest; you can also bring an API key or your own OAuth app. See authentication.
- Authorize, and give the integration a name you'll recognize.
Your agents can now call any endpoint of that service's API. There's no action list to pick from.
Ask an agent to do it
Open Chat and describe the task as you would to a new colleague:
Look at the pull requests opened in acme/api over the last week.
Summarize what shipped, and call out anything touching authentication.Watch what the agent does - you'll see it search the GitHub API, make calls, and reason about what came back. If the result isn't what you wanted, say so and let it correct.
Pin the repository as an integration resource and the agent
gets authenticated access to it - enough to git clone and run your test suite.
Put the agent on the task permanently
Once the instructions work, they're a workflow.
- In your project, choose Create Workflow and name it "Weekly PR digest".
- Paste the prompt. Add whatever the unattended version needs - where the result should go, and what to do when there's nothing to report:
Every Monday, look at the pull requests opened in acme/api over the last
week. Summarize what shipped and call out anything touching authentication.
Post the summary to #eng-standup in Slack.
If no pull requests were opened, do nothing.- Add a cron trigger. Type
every Monday at 9am Easternand Helios converts it to a cron expression for you, in UTC. - Connect Slack too, since the prompt now needs it.
Run it and watch
Dispatch the workflow manually rather than waiting for Monday. Every execution is a run with the agent's full transcript: every tool call, every response, and the final output.
If the agent did the wrong thing, the transcript shows you exactly where it went astray. Adjust the prompt and run it again.
Where to go next
- Triggers - schedules, signed webhooks, and events from GitHub, Slack, and Plain.
- Integrations - everything you can connect.
- Databases - let agents query Postgres, MySQL, or ClickHouse.
- MCP servers - bring your own tools.
- Variables and secrets - configuration without hardcoding.
- Roles and permissions - who can run what.
- Writing better prompts - getting reliable results from unattended agents.
Support
Email [email protected], or reach out through the in-app chat.
Last updated on
What is Helios?
Helios runs AI agents in cloud sandboxes. Each agent gets a real computer, the full APIs of your tools, and memory that carries between runs - with SSO, roles, and encrypted secrets around it.
Key concepts
Agents, chats, workflows, triggers, runs, sandboxes, integrations, projects, and roles - what each term means in Helios.