Working with agents
An agent combines a model, instructions, and optional connected tools. Agents belong to a workspace and can work across separate conversation threads.
Create an agent
- Make sure a model is available in your workspace. See Models and providers.
- Open Agents and select Create Agent.
- Enter an agent name and select a model.
- Add a system prompt describing the agent's role, task, and boundaries.
- Review the execution, question, and approval settings, then create the agent.
For example, a support assistant's instructions might ask it to summarize requests and flag urgent issues for a person. The instructions should reflect the actual tools and data the agent can access.
Work in threads
Open an agent to use its workspace. Send a message to start a run, and use threads to keep separate tasks and their conversation history organized. The agent workspace displays responses and tool activity as the run progresses.
You can create and rename threads, return to earlier conversations, and cancel a run when needed. Check the run's status and any tool results before relying on its output.
Archive a chat to hide it from the active list. Open Archived chats in the thread sidebar to read, restore, or permanently delete it. Restoring does not restart cancelled runs or reconnect triggers. Permanently deleting a chat removes its conversation and diagnostic content while retaining run and usage metrics. Deleting an agent permanently removes its chats and retains those metrics.
Configure the agent
Open Settings in the agent workspace to update its model, instructions, execution limits, and interaction settings. You can also attach installed apps and configure scheduled triggers from the agent workspace.
Max Steps limits the steps in a run. Leaving it blank uses an unlimited setting with a loop guard. Max Parallel Tools controls how many tool calls can run concurrently per turn.
Give an agent tools
Install an app in Apps, then use the agent's Apps control to attach it. Attaching an app exposes its available tools to the agent. Review the app's access and the agent's approval settings before running tasks that can change external systems.
See Connected apps for setup guidance.