Agents

Build your own agent

Describe an agent in your own words. The Agent Builder makes it, tests it, and you publish it for the chat.

You do not need to program to make an agent. You describe what it should do, and the Agent Builder makes it for you. It uses the AI model you chose in the app's settings.

Build an agent

  1. Open the Agent Crew tab.
  2. Under Add a new agent, click Build it yourself.
  3. Describe the agent in the message field, in plain words. For example: "Fetch the current weather for a city" or "Translate any English text I send into formal German".
  4. Send the message. The builder writes the agent and tests it. You see its progress while it works.
  5. Read the builder's reply. Not happy? Just say what should be different, in the same conversation.

Keys for outside services

Some agents use an outside service that needs your own API key. The builder then asks for it. Paste the key and save it.

Keys are stored encrypted on your computer. They are never sent over the mesh and are never part of shared agents. People who call your agent get results, never your key.

Test and publish

A new agent starts as a Draft. A draft is not in the chat yet.

  1. Test the agent first. On the agent's page, use Try it and ask it something.
  2. When it does what you want, click Publish. Then it is available in the chat.

New agents start as Team: only you, your nodes and the people you invited can use them. How to change this is explained in Agents and the Agent Crew.

Change an agent later

Select the agent in the Agent Crew and open the Agent Builder tab. Say what should be different. The builder rewrites the agent and tests it.

Until you click Publish changes, the chat keeps using the previous version.

If building does not work

Sometimes the app shows Building did not work. Usually the AI model is too small, or its context window is too short for the builder's instructions. Then:

  • Ask the builder again to save the agent (Try again).
  • If you use Ollama, raise the model's context length to 16k or more (in Ollama under Settings → Context length).
  • Or choose a larger chat model with Change the chat model.
  • Or delete the entry and start again.