[{"data":1,"prerenderedAt":173},["ShallowReactive",2],{"doc:get-started\u002Ffirst-agent":3},{"title":4,"description":5,"url":6,"markdownPath":7,"file":8,"section":9,"sectionTitle":10,"html":11,"toc":12,"navigation":32,"previous":171,"next":172},"Create your first Agent","Connect a model, create an Agent with a Role, let people use it and send it its first message in your L4 Server.","\u002Fdocs\u002Fget-started\u002Ffirst-agent","\u002Fdocs\u002Fget-started\u002Ffirst-agent.md","docs\u002Fget-started\u002Ffirst-agent.md","get-started","Get started","\u003Cp>An Agent is a non-human Member of your Server. It has a name, instructions, a model and one Role, and it can do only what that Role and the person asking allow. Each reply or piece of work is a \u003Cstrong>Run\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cp>An Agent can chat with only a model. Working on code, from a Task to a draft pull request, also needs GitHub, a repository and compute; see \u003Ca href=\"\u002Fdocs\u002Fagents\u002Frepositories\">Repositories\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"1-connect-a-model\">\u003Ca class=\"heading-anchor\" href=\"#1-connect-a-model\">1. Connect a model\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The Owner connects model Providers.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Open \u003Cstrong>Server settings → Models\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Select \u003Cstrong>Add provider\u003C\u002Fstrong> and choose one, for example OpenRouter, an Anthropic API key or ChatGPT. Keys are stored encrypted on your Server.\u003C\u002Fli>\n\u003Cli>Save the provider and pick its models.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>On a Cloudflare Server, Workers AI is listed with the other providers. The Owner can turn it off or choose which of its models Agents see.\u003C\u002Fp>\n\u003Cp>Members with \u003Cstrong>Use agents\u003C\u002Fstrong> can also connect their own ChatGPT plan in \u003Cstrong>Server settings → Models\u003C\u002Fstrong> and share it with the Server. See \u003Ca href=\"\u002Fdocs\u002Fagents\u002Fmodels-and-providers\">Models and Providers\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"2-create-the-agent\">\u003Ca class=\"heading-anchor\" href=\"#2-create-the-agent\">2. Create the Agent\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>You need \u003Cstrong>Manage agents\u003C\u002Fstrong>. The Owner has it.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Open \u003Cstrong>Server settings → Agents\u003C\u002Fstrong>, or the \u003Cstrong>Agents\u003C\u002Fstrong> page, and select \u003Cstrong>Create agent\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Enter a \u003Cstrong>Name\u003C\u002Fstrong>. No other Member can use the same name.\u003C\u002Fli>\n\u003Cli>Choose a \u003Cstrong>Model\u003C\u002Fstrong>, or leave it empty to use the Server default when one is set.\u003C\u002Fli>\n\u003Cli>Choose its \u003Cstrong>Role\u003C\u002Fstrong>. The Role caps what the Agent can do. The Owner Role cannot be assigned to an Agent.\u003C\u002Fli>\n\u003Cli>Write \u003Cstrong>Profile instructions\u003C\u002Fstrong>, or use \u003Cstrong>Fill instructions from an example\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Select \u003Cstrong>Create agent\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cfigure class=\"doc-shot doc-shot-missing\">\u003Cdiv class=\"doc-shot-frame\" role=\"img\" aria-label=\"The Create agent dialog with Avatar, Name, Works on, Model, Role and Profile instructions fields and the Create agent button\">\u003Cspan class=\"doc-shot-label\">Screenshot coming soon\u003C\u002Fspan>\u003Cspan class=\"doc-shot-alt\">The Create agent dialog with Avatar, Name, Works on, Model, Role and Profile instructions fields and the Create agent button\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cfigcaption>Create an Agent\u003C\u002Ffigcaption>\u003C\u002Ffigure>\u003C\u002Fp>\n\u003Cp>To create an Agent that runs on its own computer instead of the Server's models, turn on \u003Cstrong>Its own computer (external agent)\u003C\u002Fstrong> under \u003Cstrong>Works on\u003C\u002Fstrong>. See \u003Ca href=\"\u002Fdocs\u002Fagents\u002Fexternal-agents\">External agents\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"3-let-people-use-it\">\u003Ca class=\"heading-anchor\" href=\"#3-let-people-use-it\">3. Let people use it\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>People can find and talk to an Agent only if their Role, or a Project policy, grants \u003Cstrong>Use agents\u003C\u002Fstrong>. The built-in Member Role does not include it by default.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Open \u003Cstrong>Server settings → Roles & Policies\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Open the Role whose Members should use Agents, then its \u003Cstrong>Policies\u003C\u002Fstrong> tab.\u003C\u002Fli>\n\u003Cli>Check a policy that grants \u003Cstrong>Use agents\u003C\u002Fstrong>, or create one first, and select \u003Cstrong>Save policies\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2 id=\"4-send-it-a-message\">\u003Ca class=\"heading-anchor\" href=\"#4-send-it-a-message\">4. Send it a message\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Open a Direct Message with the Agent from the \u003Cstrong>Agents\u003C\u002Fstrong> page, or\u003C\u002Fli>\n\u003Cli>mention it directly in a conversation it can access, for example \u003Ccode>@Helper summarize this thread\u003C\u002Fcode>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Only a direct mention addresses an Agent. Role mentions and \u003Ccode>@channel\u003C\u002Fcode> or \u003Ccode>@here\u003C\u002Fcode> never wake one. Agent replies go into a Thread.\u003C\u002Fp>\n\u003Ch2 id=\"5-follow-its-work\">\u003Ca class=\"heading-anchor\" href=\"#5-follow-its-work\">5. Follow its work\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The \u003Cstrong>Runs\u003C\u002Fstrong> page lists the Runs you started. Each Run shows its activity, model requests and result. Your Inbox shows your Agent work while it is queued or running, and approvals waiting on you.\u003C\u002Fp>\n\u003Cblockquote class=\"callout callout-note\">\u003Cp class=\"callout-title\">Note\u003C\u002Fp>\u003Cp>Sending external email from an Agent always needs human approval.\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"next-steps\">\u003Ca class=\"heading-anchor\" href=\"#next-steps\">Next steps\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fagents\u002Foverview\">Agents overview\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fconcepts\u002Fagents-tasks-runs\">Agents, Tasks and Runs\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fagents\u002Fmcp\">MCP\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n",[13,17,20,23,26,29],{"id":14,"text":15,"depth":16},"1-connect-a-model","1. Connect a model",2,{"id":18,"text":19,"depth":16},"2-create-the-agent","2. Create the Agent",{"id":21,"text":22,"depth":16},"3-let-people-use-it","3. Let people use it",{"id":24,"text":25,"depth":16},"4-send-it-a-message","4. Send it a message",{"id":27,"text":28,"depth":16},"5-follow-its-work","5. Follow its work",{"id":30,"text":31,"depth":16},"next-steps","Next steps",[33,54,82,98,117,139,161],{"id":9,"title":10,"pages":34},[35,38,41,44,47,50,53],{"title":36,"url":37},"What is L4","\u002Fdocs\u002Fget-started\u002Fwhat-is-l4",{"title":39,"url":40},"Choose how to run your Server","\u002Fdocs\u002Fget-started\u002Fchoose-how-to-run",{"title":42,"url":43},"Create a Server on Cloudflare","\u002Fdocs\u002Fget-started\u002Fcreate-on-cloudflare",{"title":45,"url":46},"Install on a VPS","\u002Fdocs\u002Fget-started\u002Finstall-on-a-vps",{"title":48,"url":49},"Connect to a Server","\u002Fdocs\u002Fget-started\u002Fconnect-a-server",{"title":51,"url":52},"Invite your team","\u002Fdocs\u002Fget-started\u002Finvite-your-team",{"title":4,"url":6},{"id":55,"title":56,"pages":57},"cloudflare","Cloudflare",[58,61,64,67,70,73,76,79],{"title":59,"url":60},"L4 on Cloudflare","\u002Fdocs\u002Fcloudflare\u002Foverview",{"title":62,"url":63},"Cloudflare access","\u002Fdocs\u002Fcloudflare\u002Faccess",{"title":65,"url":66},"Costs and limits","\u002Fdocs\u002Fcloudflare\u002Fcosts-and-limits",{"title":68,"url":69},"Custom domain","\u002Fdocs\u002Fcloudflare\u002Fcustom-domain",{"title":71,"url":72},"Mail on Cloudflare","\u002Fdocs\u002Fcloudflare\u002Fmail",{"title":74,"url":75},"Update a Cloudflare Server","\u002Fdocs\u002Fcloudflare\u002Fupdates",{"title":77,"url":78},"Backups on Cloudflare","\u002Fdocs\u002Fcloudflare\u002Fbackups",{"title":80,"url":81},"Remove a Cloudflare Server","\u002Fdocs\u002Fcloudflare\u002Fremove-a-server",{"id":83,"title":84,"pages":85},"self-host","Self-host",[86,89,92,95],{"title":87,"url":88},"Run a Server on a VPS","\u002Fdocs\u002Fself-host\u002Fvps",{"title":90,"url":91},"Run a Server with Docker Compose","\u002Fdocs\u002Fself-host\u002Fdocker",{"title":93,"url":94},"Run a Server on Coolify","\u002Fdocs\u002Fself-host\u002Fcoolify",{"title":96,"url":97},"Compute Nodes","\u002Fdocs\u002Fself-host\u002Fcompute-nodes",{"id":99,"title":100,"pages":101},"concepts","Concepts",[102,105,108,111,114],{"title":103,"url":104},"Servers and the Shell","\u002Fdocs\u002Fconcepts\u002Fserver-and-shell",{"title":106,"url":107},"Accounts, Members and Roles","\u002Fdocs\u002Fconcepts\u002Faccounts-members-roles",{"title":109,"url":110},"Agents, Tasks and Runs","\u002Fdocs\u002Fconcepts\u002Fagents-tasks-runs",{"title":112,"url":113},"Files and backups","\u002Fdocs\u002Fconcepts\u002Ffiles-and-backups",{"title":115,"url":116},"Releases and updates","\u002Fdocs\u002Fconcepts\u002Freleases-and-updates",{"id":118,"title":119,"pages":120},"agents","Agents and MCP",[121,124,127,130,133,136],{"title":122,"url":123},"Agents overview","\u002Fdocs\u002Fagents\u002Foverview",{"title":125,"url":126},"Models and Providers","\u002Fdocs\u002Fagents\u002Fmodels-and-providers",{"title":128,"url":129},"Connect an MCP client","\u002Fdocs\u002Fagents\u002Fmcp",{"title":131,"url":132},"External agents","\u002Fdocs\u002Fagents\u002Fexternal-agents",{"title":134,"url":135},"Repositories and code work","\u002Fdocs\u002Fagents\u002Frepositories",{"title":137,"url":138},"Schedules","\u002Fdocs\u002Fagents\u002Fschedules",{"id":140,"title":141,"pages":142},"guides","Guides",[143,146,149,152,155,158],{"title":144,"url":145},"Chat","\u002Fdocs\u002Fguides\u002Fchat",{"title":147,"url":148},"Projects and Tasks","\u002Fdocs\u002Fguides\u002Fprojects-and-tasks",{"title":150,"url":151},"Mail","\u002Fdocs\u002Fguides\u002Fmail",{"title":153,"url":154},"Calls and Live","\u002Fdocs\u002Fguides\u002Fcalls",{"title":156,"url":157},"Notifications","\u002Fdocs\u002Fguides\u002Fnotifications",{"title":159,"url":160},"Telegram","\u002Fdocs\u002Fguides\u002Ftelegram",{"id":162,"title":163,"pages":164},"reference","Reference",[165,168],{"title":166,"url":167},"Glossary","\u002Fdocs\u002Freference\u002Fglossary",{"title":169,"url":170},"Troubleshooting","\u002Fdocs\u002Freference\u002Ftroubleshooting",{"title":51,"url":52},{"title":59,"url":60},1793304297751]