How-to guides
Task-oriented recipes for common Everruns workflows, equipping agents with tools, streaming events, deploying to channels, and operating production agents.
These guides target the Everruns Platform (the Everruns demo instance or self-hosted). Framework guides live under /framework/.
Each how-to here solves one concrete problem. They assume you already understand the basics (read the Tutorials first) and they don’t try to teach concepts (see Explanation for that).
Building agents
Section titled “Building agents”- Equip an agent with tools, pick capabilities and assign them.
- Give an agent web access,
web_fetch, network policies, allowlists. - Define agents as files, version-controllable agent definitions in Markdown, TOML, or YAML.
- Use AGENTS.md for project instructions, inject project-level context into the system prompt.
- Customize a harness, create your own harness as a starting point for many agents.
- Share knowledge with OKF, import/export Knowledge Bases as Open Knowledge Format bundles, managed like code.
- Migrate between LLM providers, swap OpenAI ↔ Anthropic ↔ Gemini without rewriting agents.
Running agents
Section titled “Running agents”- Call your agent from code, give an application its own key to one agent, act for your users, and reach it from a browser.
- Stream events, consume the SSE stream from the Python SDK, or from curl, EventSource, or any HTTP client, with reconnection and event filtering.
- Complete a URL elicitation over the API, drive the pause-and-consent flow from your own client.
- Handle errors and cancel turns, graceful failure paths, turn cancellation, retries.
- Orchestrate multi-agent pipelines, chain sessions together.
- Build a foreman agent, put one agent in front of a team of specialists and let it triage and delegate.
Packaging and distribution
Section titled “Packaging and distribution”- Package and publish an agent skill, author a SKILL.md, bundle scripts and references, and share it across agents through the registry.
- Publish an agent as a Slack app, deploy an agent to a Slack workspace.
- Summarize GitHub pull requests, connect GitHub and comment a summary on every pull request.
- Set up review and security agents, review every pull request and scan a repository for vulnerabilities on a schedule, on any model.
Operating
Section titled “Operating”- Automate with the CLI, scripting against the CLI with
jq. - Deploy with Docker Compose, bring up the full platform.
- Enforce a budget, cap token spend per agent, session, or organization.