Todos os produtos
Search

Este produto

    :Overview

    Central de documentação

    :Overview

    Última atualização: Sep 24, 2026

    Qoder Cloud Agents CN é uma plataforma de execução de agentes de IA totalmente gerenciada. Não é necessário construir seu próprio loop de agente, gerenciar um sandbox de execução de ferramentas nem lidar com conexões de longa duração. Basta definir um agente e iniciar uma sessão via API para executar tarefas complexas e receber resultados em tempo real na cloud.

    Importante

    O novo site de documentação do Qoder CN já está disponível. O conteúdo desta página pode não refletir os recursos e as alterações mais recentes do product. Acesse docs.qoder.cn para consultar a documentação mais atualizada.

    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 do cargo de um funcionário

    environment

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

    Uma mesa de trabalho e uma caixa de ferramentas

    session

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

    Uma sessão de trabalho específica

    event

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

    Transmissão ao vivo do progresso de uma tarefa

    Fluxo de trabalho

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

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

    3. Inicie uma session — Vincule um agent a um environment para criar uma instância de execução.

    4. Envie mensagens e receba events — Envie um user.message para a session e receba um fluxo de eventos em tempo real — como pensamentos do agent, mensagens e alterações de status — via 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ções em larga escala e geração automatizada de testes.

    • Integração via API — Incorpore capacidades de agent nos seus serviços de backend sem precisar manter um runtime.

    • Processamento em lote — Inicie múltiplas sessions em paralelo para processar requisições em lote.

    • Tarefas agendadas — Integre com um sistema de agendamento para executar agents periodicamente em inspeções ou geração de relatórios.

    Autenticação

    Todas as requisições à API devem incluir o seguinte header:

    Header

    Value

    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 o PAT com segurança e não o inclua em repositórios de código.

    Paginação

    As APIs de listagem utilizam 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 navegar entre as páginas.

    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 é projetado para automação e integração. As duas ferramentas são complementares.

    P: Quantas sessions um único agent pode executar simultaneamente?

    R: Não há limite fixo. Uma configuração de agent pode estar associada a múltiplas sessions ativas ao mesmo tempo.

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

    R: Cada session é executada em um sandbox de contêiner isolado, impedindo o acesso entre sessions. Todos os dados são removidos quando o environment é destruído.

    Próximos passos