DescribePolarClawAgents - PolarDB: Central de Documentação do Alibaba Cloud

Consulta todos os plug-ins instalados e suas informações de status em um aplicativo especificado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:DescribePolarClawAgents

none

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ApplicationId	string	Sim	O ID do aplicativo.	pa-**************
AgentList	array	Não	A lista de IDs de agentes a descrever.	work,research
	string	Não	A lista de agentes.	work

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	24A1990B-4F6E-482B-B8CB-75C612******
Message	string	A mensagem de resposta.	successful
Code	integer	O código de status da resposta.	200
ApplicationId	string	O ID do aplicativo.	pa-**************
DefaultId	string	O ID do agente padrão.	main
MainKey	string	O nome da chave do agente principal.	main
Scope	string	O escopo de roteamento.	per-sender
Agents	array<object>	A lista de agentes.
	array<object>	Agente.
Id	string	O ID do agente.	main
Name	string	O nome de exibição do agente.	main
Identity	object	As informações de identidade.
Name	string	O nome da identidade.	PolarClaw
Theme	string	O tema.	space lobster
Emoji	string	O identificador de emoji no formato de codificação Unicode, como U+1F99E, ou um caractere de emoji direto.	U+1F99E
Avatar	string	O caminho ou conteúdo do avatar.	test
AvatarUrl	string	A URL do avatar.	test
Workspace	string	O caminho do diretório de trabalho.	/home/node/.openclaw/workspace-work
Default	boolean	Indica se este é o agente padrão.	true
Model	object	A configuração do modelo.
Primary	string		claude-sonnet-4-5
Fallbacks	array
	string		claude-haiku-4-5
Skills	array	A lista de habilidades disponíveis para o agente.
	string	O identificador de habilidade.	alibacloud-rds-copilot
Files	array<object>	A lista de arquivos do agente.
	object	As informações do arquivo.
Name	string		SOUL.md
Path	string		/home/node/.openclaw/workspace-work/SOUL.md
Missing	boolean		false
Size	integer		1024
UpdatedAtMs	integer		1716000000000

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "24A1990B-4F6E-482B-B8CB-75C612******",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "DefaultId": "main",
  "MainKey": "main",
  "Scope": "per-sender",
  "Agents": [
    {
      "Id": "main",
      "Name": "main",
      "Identity": {
        "Name": "PolarClaw",
        "Theme": "space lobster",
        "Emoji": "U+1F99E",
        "Avatar": "test",
        "AvatarUrl": "test"
      },
      "Workspace": "/home/node/.openclaw/workspace-work",
      "Default": true,
      "Model": {
        "Primary": "claude-sonnet-4-5",
        "Fallbacks": [
          "claude-haiku-4-5"
        ]
      },
      "Skills": [
        "alibacloud-rds-copilot"
      ],
      "Files": [
        {
          "Name": "SOUL.md",
          "Path": "/home/node/.openclaw/workspace-work/SOUL.md",
          "Missing": false,
          "Size": 1024,
          "UpdatedAtMs": 1716000000000
        }
      ]
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.