# How-to guides

> Task-oriented recipes for common Everruns workflows, equipping agents with tools, streaming events, deploying to channels, and operating production agents.

Source: <https://everruns.com/docs/how-to/>

These guides target the Everruns Platform (Everruns Cloud or self-hosted). Framework guides live under [/framework/](https://everruns.com/docs/framework/).

Each how-to here solves one concrete problem. They assume you already understand the basics (read the [Tutorials](https://everruns.com/docs/tutorials/run-an-agent/) first) and they don’t try to teach concepts (see [Explanation](https://everruns.com/docs/explanation/) for that).

## Building agents

* [Equip an agent with tools](https://everruns.com/docs/how-to/equip-agents-with-tools/), pick capabilities and assign them.
* [Give an agent web access](https://everruns.com/docs/how-to/give-an-agent-web-access/), `web_fetch`, network policies, allowlists.
* [Define agents as files](https://everruns.com/docs/how-to/define-agents-as-files/), version-controllable agent definitions in Markdown, TOML, or YAML.
* [Use AGENTS.md for project instructions](https://everruns.com/docs/how-to/use-agents-md/), inject project-level context into the system prompt.
* [Customize a harness](https://everruns.com/docs/how-to/customize-a-harness/), create your own harness as a starting point for many agents.
* [Share knowledge with OKF](https://everruns.com/docs/how-to/share-knowledge-with-okf/), import/export Knowledge Bases as Open Knowledge Format bundles, managed like code.
* [Migrate between LLM providers](https://everruns.com/docs/how-to/migrate-providers/), swap OpenAI ↔ Anthropic ↔ Gemini without rewriting agents.

## Running agents

* [Call your agent from code](https://everruns.com/docs/how-to/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](https://everruns.com/docs/how-to/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](https://everruns.com/docs/how-to/complete-a-url-elicitation/), drive the pause-and-consent flow from your own client.
* [Handle errors and cancel turns](https://everruns.com/docs/how-to/handle-errors-and-cancellation/), graceful failure paths, turn cancellation, retries.
* [Orchestrate multi-agent pipelines](https://everruns.com/docs/how-to/orchestrate-multi-agent-pipelines/), chain sessions together.
* [Build a foreman agent](https://everruns.com/docs/how-to/build-a-foreman-agent/), put one agent in front of a team of specialists and let it triage and delegate.

## Packaging and distribution

* [Package and publish an agent skill](https://everruns.com/docs/how-to/package-a-skill/), author a SKILL.md, bundle scripts and references, and share it across agents through the registry.
* [Publish an agent as a Slack app](https://everruns.com/docs/how-to/publish-to-slack/), deploy an agent to a Slack workspace.
* [Summarize GitHub pull requests](https://everruns.com/docs/how-to/summarize-github-pull-requests/), connect GitHub and comment a summary on every pull request.
* [Set up review and security agents](https://everruns.com/docs/how-to/set-up-review-and-security-agents/), review every pull request and scan a repository for vulnerabilities on a schedule, on any model.

## Operating

* [Automate with the CLI](https://everruns.com/docs/how-to/automate-with-the-cli/), scripting against the CLI with `jq`.
* [Deploy with Docker Compose](https://everruns.com/docs/getting-started/docker-compose/), bring up the full platform.
* [Enforce a budget](https://everruns.com/docs/how-to/enforce-a-budget/), cap token spend per agent, session, or organization.