AI

Agents and the Agent Stack

Agent sessions, events, review of write tools and Agent Manager.

An agent combines instructions, a model role, retrieval context and a set of tools. You build agents in Agents and watch their sessions in Agent Manager.

Agents

An agent definition is a resource like any other. A new agent is private, in your personal project, until you share it. Access is checked with your own credentials every time.

Tools an agent can use:

Each tool runs in auto or confirm mode. Write tools are always in confirm mode.

Sessions

A conversation with an agent is a session. A session is an append-only log of events, from which Converge derives the session's content items: messages, tool calls, tool results, review requests and decisions, outputs and errors.

Session states:

Clients may add three kinds of events: a user message, a review decision, and a cancel.

Context

Session inputs are inserted into the agent's instructions, and their values are passed to the model marked as untrusted. Retrieval context (documents and objects the agent may draw on) can be set per session.

Human review of write tools

When an agent wants to call a write tool, the session moves to awaiting_review and records a review request with the proposed call. Nothing is written until a person confirms it. Rejecting it tells the agent the call was declined.

POST /ai/v2/aipAgents/{agentRid}/sessions/{sessionId}/toolCalls/{callId}/confirm
POST /ai/v2/aipAgents/{agentRid}/sessions/{sessionId}/toolCalls/{callId}/reject

In preview sessions, write calls are validated and recorded as skipped, but never run.

Agent Manager

Agent Manager lists the sessions of your agents: what each did step by step, its state, and what waits for a decision. You see a session when you own it, or when you can edit the agent and hold the session's markings.

API