API de sessões de agentes

Gerencie o estado da conversa. Criar um registro de sessão, por si só, não inicia uma execução de IA. Use o aplicativo Adios ou a integração MCP para iniciar o trabalho do agente.

Usar Autenticação da API para pedidos protegidos. Exemplos usam seus próprios IDs de recursos e um token temporário; exemplos de resposta salvos são sintéticos.

Método	Caminho	Operação
GET	/v1/agent_session	Listar sessões de agentes
POST	/v1/agent_session	Criar sessão de agente
GET	/v1/agent_session/{id}	Obter sessão do agente
PUT	/v1/agent_session/{id}	Atualizar sessão de agente
DELETE	/v1/agent_session/{id}	Apagar a sessão do agente
GET	/v1/agent_session/{id}/state	Obter o estado da sessão do agente
GET	/v1/agent_session/{id}/plan	Obter o plano de sessão do agente
POST	/v1/agent_session/{id}/runs/{run_id}/cancel	Cancelar a execução do agente

Listar sessões de agentes

GET /v1/agent_session

Retorna uma lista paginada de AgentSession

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
page	consulta	não	Número da página
per_page	consulta	não	Itens por página

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_session" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Resposta: HTTP 200

Lista de AgentSession

Campos de resposta

Campo	Tipo	Descrição
data	array
data[].agent_session_id	string
data[].channel_id	string
data[].company_project_id	string
data[].context_snapshot	objeto
data[].created_at	inteiro	(Timestamp Unix)
data[].deleted_at	inteiro	(Timestamp Unix)
data[].last_message_at	inteiro	(Timestamp Unix)
data[].memory_summary	objeto
data[].metadata	objeto
data[].mode	string	Valores permitidos: build, debug, ops, review, chat.
data[].model	string
data[].owner_id	string
data[].provider	string
data[].sharing_scope	string	Valores permitidos: private, team.
data[].source	string	Valores permitidos: app, slack, cli.
data[].status	string	Valores permitidos: active, paused, blocked, complete, failed.
data[].team_id	string
data[].thread_id	string
data[].updated_at	inteiro	(Timestamp Unix)
data[].workspace_id	string
data[].writable_repository_id	string
pagination	objeto
pagination.page	inteiro	Número da página atual
pagination.per_page	inteiro	Número de itens por página
pagination.total	inteiro	Número total de itens

Exemplo ilustrativo; não é uma resposta real:

{
  "data": [
    {
      "agent_session_id": "000000000000000000000000001",
      "channel_id": "",
      "company_project_id": "",
      "context_snapshot": {},
      "created_at": 1791072000,
      "deleted_at": 0,
      "last_message_at": 0,
      "memory_summary": {},
      "metadata": {},
      "mode": "chat",
      "model": "",
      "owner_id": "",
      "provider": "",
      "sharing_scope": "private",
      "source": "app",
      "status": "active",
      "team_id": "000000000000000000000000001",
      "thread_id": "",
      "updated_at": 1791072000,
      "workspace_id": "",
      "writable_repository_id": ""
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Criar sessão de agente

POST /v1/agent_session

Cria um novo objeto AgentSession

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Campos da requisição (o corpo contém um exemplo editável):

Campo	Tipo	Obrigatório	Descrição
channel_id	string	não	Padrão: "".
company_project_id	string	não	Padrão: "".
context_snapshot	objeto	não
last_message_at	inteiro	não	(Timestamp Unix) Padrão: 0.
memory_summary	objeto	não
metadata	objeto	não
mode	string	sim	Valores permitidos: build, debug, ops, review, chat. Padrão: "chat".
model	string	não	Padrão: "".
owner_id	string	não	Padrão: "".
provider	string	não	Padrão: "".
sharing_scope	string	sim	Valores permitidos: private, team. Padrão: "private".
source	string	sim	Valores permitidos: app, slack, cli.
status	string	sim	Valores permitidos: active, paused, blocked, complete, failed. Padrão: "active".
team_id	string	sim
thread_id	string	não	Padrão: "".
workspace_id	string	não	Padrão: "".
writable_repository_id	string	não	Padrão: "".

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/agent_session" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "owner_id": "YOUR_USER_ID",
  "workspace_id": "YOUR_WORKSPACE_ID",
  "sharing_scope": "private",
  "source": "app",
  "mode": "chat",
  "status": "active"
}
JSON

Substitua YOUR_* no corpo antes de enviar. O heredoc com delimitador entre aspas mantém o JSON literal.

Resposta: HTTP 201

AgentSession criado

Campos de resposta

Campo	Tipo	Descrição
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	objeto
created_at	inteiro	(Timestamp Unix)
deleted_at	inteiro	(Timestamp Unix)
last_message_at	inteiro	(Timestamp Unix)
memory_summary	objeto
metadata	objeto
mode	string	Valores permitidos: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valores permitidos: private, team.
source	string	Valores permitidos: app, slack, cli.
status	string	Valores permitidos: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	inteiro	(Timestamp Unix)
workspace_id	string
writable_repository_id	string

Exemplo ilustrativo; não é uma resposta real:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Obter sessão do agente

GET /v1/agent_session/{id}

Retorna um objeto AgentSession

Defina agent_session_id usando IDs das suas próprias respostas da API.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Resposta: HTTP 200

AgentSession

Campos de resposta

Campo	Tipo	Descrição
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	objeto
created_at	inteiro	(Timestamp Unix)
deleted_at	inteiro	(Timestamp Unix)
last_message_at	inteiro	(Timestamp Unix)
memory_summary	objeto
metadata	objeto
mode	string	Valores permitidos: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valores permitidos: private, team.
source	string	Valores permitidos: app, slack, cli.
status	string	Valores permitidos: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	inteiro	(Timestamp Unix)
workspace_id	string
writable_repository_id	string

Exemplo ilustrativo; não é uma resposta real:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Atualizar sessão de agente

PUT /v1/agent_session/{id}

Atualiza um objeto AgentSession existente

Defina agent_session_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Campos da requisição (o corpo contém um exemplo editável):

Campo	Tipo	Obrigatório	Descrição
channel_id	string	não	Padrão: "".
company_project_id	string	não	Padrão: "".
context_snapshot	objeto	não
last_message_at	inteiro	não	(Timestamp Unix) Padrão: 0.
memory_summary	objeto	não
metadata	objeto	não
mode	string	sim	Valores permitidos: build, debug, ops, review, chat. Padrão: "chat".
model	string	não	Padrão: "".
owner_id	string	não	Padrão: "".
provider	string	não	Padrão: "".
sharing_scope	string	sim	Valores permitidos: private, team. Padrão: "private".
source	string	sim	Valores permitidos: app, slack, cli.
status	string	sim	Valores permitidos: active, paused, blocked, complete, failed. Padrão: "active".
team_id	string	sim
thread_id	string	não	Padrão: "".
workspace_id	string	não	Padrão: "".
writable_repository_id	string	não	Padrão: "".

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request PUT "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "owner_id": "YOUR_USER_ID",
  "workspace_id": "YOUR_WORKSPACE_ID",
  "sharing_scope": "private",
  "source": "app",
  "mode": "chat",
  "status": "active"
}
JSON

Substitua YOUR_* no corpo antes de enviar. O heredoc com delimitador entre aspas mantém o JSON literal.

Resposta: HTTP 200

AgentSession atualizado

Campos de resposta

Campo	Tipo	Descrição
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	objeto
created_at	inteiro	(Timestamp Unix)
deleted_at	inteiro	(Timestamp Unix)
last_message_at	inteiro	(Timestamp Unix)
memory_summary	objeto
metadata	objeto
mode	string	Valores permitidos: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valores permitidos: private, team.
source	string	Valores permitidos: app, slack, cli.
status	string	Valores permitidos: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	inteiro	(Timestamp Unix)
workspace_id	string
writable_repository_id	string

Exemplo ilustrativo; não é uma resposta real:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Apagar a sessão do agente

DELETE /v1/agent_session/{id}

Exclui um objeto AgentSession

Defina agent_session_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Resposta: HTTP 200

O recurso foi apagado.

Campos de resposta

Campo	Tipo	Descrição
message	string

Exemplo ilustrativo; não é uma resposta real:

{
  "message": "Deleted successfully"
}

Obter o estado da sessão do agente

GET /v1/agent_session/{id}/state

Leia o estado da sessão.

Defina agent_session_id usando IDs das suas próprias respostas da API.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}/state" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Obter o plano de sessão do agente

GET /v1/agent_session/{id}/plan

Leia o plano atual da sessão.

Defina agent_session_id usando IDs das suas próprias respostas da API.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}/plan" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Cancelar a execução do agente

POST /v1/agent_session/{id}/runs/{run_id}/cancel

Solicitar o cancelamento de uma execução ativa na sessão.

Defina agent_session_id, agent_run_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
run_id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}/runs/${ADIOS_AGENT_RUN_ID}/cancel" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.