Skip to content

Add an agent

An agent is a program that calls models on its own: a support bot, a nightly summariser, a copywriter. Giving it its own identity means a cost, a refusal or an incident lands on a system with an owner and someone to ask, not on "a key". It never signs in and has no email; it calls models with its own keys.

Before you start

  • Anyone can add an agent in a team they're directly in, and becomes its owner. Group admins add them anywhere in their part of the organisation; organisation admins anywhere, including the whole organisation.
  • To issue its first key, you must be allowed to issue keys in the environment you choose. In the default environment, owners issue their agents' keys.

Steps

  1. Open Applications & agents and choose New agent. Each step has Back to change your mind.
  2. About it: a name (unique within its team), where it belongs (chosen for you if you're in one team), and optionally what it's for, who to ask about it, and its version or label (such as v2.3 or experimental). On the Enterprise edition, optionally Keep calls in a region: the next step then offers only models placed there.
  3. Models: Same as its team (the usual choice), These models (some of its team's), or No models for now.
  4. Owners (admins of its team only): others who should look after it. You own it already.
  5. Applications (when you control some): the applications it joins.
  6. First key: Issue it now (choose the environment, a name, optionally an expiry and only some of its models, and which application it acts for) or Issue later.
  7. Check and create shows everything; choose Create agent.
  8. Copy the key's secret. It's shown once, with Copy; the panel stays open until you choose Done, which opens the agent's page.

Adding the fjordair-care-bot agent with its first key, step by step

Check it worked

The agent's page opens: Overview with its team, owners and how many live keys it has in how many environments. Could call now, under Models, goes through every model and says whether its keys could call it, and why not.

If a step was refused

The summary says what happened at each step. If one step was refused (an owner who couldn't be added, say), the rest still went through, and the summary says why in words. Fix it from the agent's page.

Good to know

  • An agent with no live key says No key and can't call any model; Home lists it under Needs attention.
  • An agent isn't tied to one environment: give it a key in each environment it runs in.
  • An agent can only have models its team allows.