agent4.io Cookbook
Recipes for building on agent4.io from a coding agent. Each one names the exact MCP tool and arguments — connect once, then paste a task and let your agent run it.
Design principles
agent4-io-principlesRead first: how to configure agents that actually work.
Getting started
agent4-io-recipesConnect over MCP, install the skills, run your first recipe.
Agents & skills
agent4-io-adminCreate agents with boundaries and package load-on-demand skills.
Create an agent with a soul, a task with boundaries, tools and a knowledge base — over MCP.
list_toolslist_knowledge_basescreate_agentPackage a capability the model pulls only when relevant — create it and attach it to an agent.
list_skillscreate_skillupdate_agentGive the agent a per-page briefing — background, an opening line and suggested questions — chosen automatically from the visitor's URL, over MCP.
list_page_contextsupsert_page_contextresolve_page_contextA shared library of general working methods available to every agent, retrieved by intent rather than attached one by one.
list_skillscreate_skillupdate_agentDeletions aren't MCP tools; tell the user the exact console screen and button instead.
Register a remote MCP server so your agents can call its tools — via the console or REST.
list_mcp_serverslist_toolsupdate_agentThe tools the platform ships — lead capture, documents, follow-ups, web search — plus the auto-installed time/weather/location server.
list_toolsupdate_agentRead token usage and the monthly quota over MCP — by agent, user, space, day or model — to answer "am I close to my limit?" and "what's driving the cost?".
tenant_infousage_statsList your end users and their chat sessions over MCP — directory and metadata only; transcripts stay in the console, reached by a link the tools hand back.
list_end_usersget_end_userlist_user_sessionsMatch a customer's brand on a share link or embedded widget: one colour, a logo, and CSS only when the brand guide demands it.
list_sharesconfigure_shareset_pwa_brandingYour agent draws a chart when an answer carries comparable numbers. Nothing to switch on. What you do control is whether the figures are in the knowledge base, and whether derived numbers go through a tool.
list_toolsupdate_agentsearch_knowledge_baseKnowledge bases
agent4-io-knowledgeBuild, populate, verify and query grounded knowledge.
Create a KB, add text and files, and verify retrieval before mounting it — over MCP.
create_knowledge_baseadd_knowledge_textadd_knowledge_fileSearch a tenant knowledge base over MCP — authenticated, private by default.
list_knowledge_basessearch_knowledge_baseStorylines
agent4-io-storylineTurn multi-step processes into stateful, guided flows.
Turn a multi-step process into a stateful directed graph — create, validate, publish.
create_storylinevalidate_storylinepublish_storylineThe paradigm and pitfalls for turning a real business process into a Storyline that behaves.
create_storylinevalidate_storylineupdate_storylineAn AND-join: several sub-flows run in any order, each with its own checks; continue only when all are done.
create_storylinevalidate_storyline