Todos os produtos
Search

Este produto

    Qoder CN Series:Visão geral

    Central de documentação

    Qoder CN Series:Visão geral

    Última atualização: Jul 03, 2026

    O Qoder Cloud Agents CN é uma plataforma de runtime para agentes de IA totalmente gerenciada. Você não precisa criar seu próprio loop de agente, gerenciar um sandbox de execução de ferramentas nem lidar com conexões persistentes. Basta definir um agente e iniciar uma sessão pela API para executar tarefas complexas e obter resultados em tempo real na nuvem.

    Conceitos principais

    Conceito

    Descrição

    Analogia

    agent

    Modelo de configuração reutilizável que define o modelo, o prompt do sistema e o conjunto de ferramentas.

    Descrição de cargo de um funcionário

    environment

    Ambiente de contêiner onde uma sessão é executada, incluindo configurações de rede e dependências.

    Mesa de trabalho e caixa de ferramentas

    session

    Instância específica de uma conversa ou execução de tarefa.

    Sessão de trabalho específica

    event

    Fluxo de eventos em tempo real gerados em uma sessão.

    Transmissão em tempo real do progresso do trabalho

    Fluxo de trabalho

    1. Defina um agente — Especifique o modelo, o prompt do sistema e as ferramentas disponíveis.

    2. Configure um ambiente — Selecione o tipo de contêiner, a política de rede e as dependências pré-instaladas. Novas contas devem usar primeiro POST /environments para criar um ambiente, pois nenhum é fornecido por padrão.

    3. Inicie uma sessão — Vincule um agente a um ambiente para criar uma instância de runtime.

    4. Envie mensagens e receba eventos — Envie uma user.message para a sessão e receba um fluxo de eventos em tempo real (como pensamentos do agente, mensagens e alterações de status) por meio de Server-Sent Events (SSE) ou polling.

    Verifique a conectividade

    # Verify PAT and list agents
curl -s https://api.qoder.com.cn/api/v1/cloud/agents \
  -H "Authorization: Bearer $QODER_PAT"

    Uma resposta bem-sucedida tem o seguinte formato:

    {
  "data": [ ],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

    Casos de uso

    • Tarefas assíncronas de longa duração — Revisões de código, refatoração em grande escala e geração automatizada de testes.

    • Integração de API — Incorpore recursos de agentes aos seus serviços de backend sem manter um runtime.

    • Processamento em lote — Inicie várias sessões em paralelo para processar solicitações em lote.

    • Tarefas agendadas — Integre um sistema de agendamento para executar agentes periodicamente em inspeções ou relatórios.

    Autenticação

    Todas as solicitações de API devem incluir o seguinte cabeçalho:

    Cabeçalho

    Valor

    Descrição

    Authorization

    Bearer <PAT>

    Token de acesso pessoal

    Crie um token de acesso pessoal (PAT) no console do Qoder acessando Settings > Personal Access Tokens. Armazene seu PAT com segurança e não faça commit dele em um repositório de código.

    Paginação

    As APIs de lista usam paginação baseada em cursor. A estrutura da resposta é a seguinte:

    {
  "data": [...],
  "first_id": "agent_019e451902fe7a2ca42c2dfc62d9320e",
  "last_id": "agent_019e45369b3379e18bfaf59b3aad2fc9",
  "has_more": true
}

    Use os parâmetros de consulta after_id e before_id para paginar.

    Perguntas frequentes

    P: Posso usar o Qoder Cloud Agents CN e o Qoder CLI ao mesmo tempo?

    R: Sim. O Qoder CLI é ideal para desenvolvimento local e interativo, enquanto o Qoder Cloud Agents CN foi projetado para automação e integração. As duas soluções são complementares.

    P: Quantas sessões um único agente pode executar simultaneamente?

    R: Não há limite rígido. Uma configuração de agente pode ser associada a várias sessões ativas ao mesmo tempo.

    P: Como a segurança dos dados é garantida?

    R: Cada sessão roda em um sandbox de contêiner isolado, o que impede o acesso entre sessões. Todos os dados são apagados quando o ambiente é destruído.

    Próximas etapas