:Gerenciar extensões

Instalar uma suite especializada

1. No painel de navegação à esquerda do Data Agent, clique em Extensions > Expert Suites.

2. Na página Expert Suites, clique em Install Suite.

3. Na caixa de diálogo Install Expert Suite, selecione um método de instalação. Há suporte para as três fontes de instalação a seguir:

   • Remote Repository: recupera o conteúdo da suite de um repositório git ou de um marketplace de suites. Utilize esta fonte para suites hospedadas em repositórios git https ou publicadas no Claude Marketplace ou no marketplace Gemini. Use Ref para fixar uma branch, tag ou commit.

   • npm Package: baixa e instala um pacote de suite versionado a partir de um registro npm. Utilize esta fonte para suites distribuídas como pacotes npm versionados. Acrescente @version ao nome do pacote para especificar uma versão.

   • Local Path / Upload: instala a partir de um diretório local ou de um arquivo compactado enviado. Esta fonte não depende de repositório ou registro e é adequada para ambientes offline ou suites internas não publicadas.

   As principais diferenças entre Remote Repository e npm Package são: a primeira recupera conteúdo de um repositório git ou marketplace, fixa a versão com Ref e usa as credenciais git da instância para repositórios privados; a segunda recupera artefatos de pacotes publicados de um registro npm, fixa a versão com o sufixo @version no nome do pacote e utiliza a configuração .npmrc / NPM_TOKEN da instância para registros privados. Forneça as seguintes informações para cada fonte:

   Fonte de instalação	Entrada	Descrição
   Remote Repository	Repository: insira um identificador de repositório em um dos três formatos: owner/repo (por exemplo, myorg/my-suite), URL git https ou owner/repo:plugin-name (para instalar um plugin de um repositório multi-plugin) Ref: opcional. Insira uma branch, tag ou commit para fixar a versão. Se deixado em branco, o sistema usa a branch padrão do repositório.	Instala a partir do Claude Marketplace, extensões cli do Gemini ou repositórios git https. Você pode navegar pelos marketplaces Gemini e Claude Code. Caso nenhum plugin seja especificado para uma fonte de marketplace, selecione um durante a instalação. Repositórios privados usam as credenciais git da instância.
   npm Package	Package name: insira um nome de pacote com escopo publicado, opcionalmente com uma versão, como @scope/my-extension@1.2.0 Registry: registro npm de origem. Se deixado em branco, o sistema usa a configuração .npmrc / NPM_TOKEN da instância.	Instala um pacote com escopo a partir de um registro npm. Apenas nomes de pacotes com escopo (@scope/name) têm suporte para evitar confusão com o formato owner/repo.
   Local Path / Upload	Caminho de diretório local ou arquivo compactado	Instala a partir de um diretório local ou de um arquivo compactado enviado

   Nota

   Remote Repository sempre instala por meio do daemon. npm Package envia diretamente quando o daemon oferece suporte. Local Path e arquivos compactados enviados ainda executam qwen extensions install no terminal.

4. Clique em Confirm Installation para concluir a instalação. Após a conclusão bem-sucedida, verifique na página Expert Suites se a suite aparece na lista. Se a instalação falhar, confira a mensagem de erro na entrada da suite.

Gerenciar suites especializadas instaladas

Após a instalação, ative ou desative uma suite pelo menu de ações. A ativação e a desativação de suites (incluindo operações em massa) entram em vigor na instância atual:

Usar suites especializadas em uma tarefa

Na caixa de entrada de tarefas do Data Agent, insira @ e selecione Expert Suites no menu para referenciar uma suite especializada ativada. O agente usa as capacidades integradas da suite (skills, servidores MCP, entre outros) para concluir a tarefa.

Skills integradas

O Data Agent inclui skills integradas do DataWorks que não exigem instalação. Após ativar uma skill integrada, invoque-a em tarefas. Na página Skills, mude para a aba DataWorks para visualizar as skills integradas disponíveis na instância atual e ativá-las ou desativá-las conforme necessário. A tabela a seguir apresenta exemplos de skills integradas frequentemente usadas. A lista real está sujeita à interface do product.

Instalar uma skill

Na aba Open Skills, clique em Install em um cartão de skill para instalar diretamente uma skill do marketplace. Para instalar uma skill personalizada, use a caixa de diálogo Install Skill para enviar um pacote ZIP ou executar um comando de instalação.

1. No painel de navegação à esquerda do Data Agent, clique em Extensions > Skills.

2. Na página Skills, clique em Install Skill.

3. Na caixa de diálogo Install Skill, selecione um método de instalação e forneça as informações necessárias:

   Enviar um pacote ZIP

   Selecione um local de instalação:

   Local de instalação	Descrição
   Install to current instance	Grava apenas localmente na instância e não faz upload para a plataforma. Pode atualizar uma skill local existente.
   Publish to skill platform	Faz upload para a cloud e compartilha dentro do escopo selecionado, além de instalar na instância atual. Selecione um escopo: Workspace ou Tenant.

   Clique ou arraste um arquivo para a área pontilhada para enviar um pacote ZIP. Apenas arquivos .zip têm suporte, até 50 MB por arquivo.

   Importante

   O diretório raiz do ZIP deve conter SKILL.md. O sistema lê o nome e a descrição da skill dos metadados do SKILL.md, e outros arquivos servem como anexos de recursos referenciados por caminho relativo. Limites: SKILL.md ≤ 200 KB; todo o pacote ZIP ≤ 50 MB.

   O pacote ZIP aceita as duas estruturas a seguir: coloque SKILL.md e arquivos de recursos diretamente no diretório raiz ou coloque-os sob um único diretório de nível superior:

   # Structure 1: root-level structure
   my-skill.zip
   ├── SKILL.md         # Required. Contains the name, description, and body
   ├── data/sample.csv  # Resource attachment
   └── images/demo.png
   
   # Structure 2: single top-level directory wrapper
   my-skill.zip
   └── my-skill/
       ├── SKILL.md         # Required. Contains the name, description, and body
       ├── data/sample.csv  # Resource attachment
       └── images/demo.png

   Clique em Install to Instance.

   Instalação por comando

   Na caixa de texto Command Install, cole um comando de instalação de skill para o Qwen Code.

   Clique em Run Install.

   A instalação por comando requer acesso público no grupo de recursos atual.

4. Na página Skills, verifique se a skill desejada aparece na lista.

Gerenciar skills instaladas

Na página Skills, execute as seguintes ações em uma skill desejada:

Usar skills em uma tarefa

Na caixa de entrada de tarefas, insira / para selecionar e invocar uma skill desejada. O agente executa a tarefa atual seguindo o fluxo predefinido da skill.

Adicionar um servidor MCP

1. No painel de navegação à esquerda do Data Agent, clique em Extensions > MCP.

2. Clique em Add MCP Server.

3. Na caixa de diálogo Add MCP Server, configure os seguintes parâmetros:

4. Diferenças entre os três métodos de transporte:

   Parâmetro	Tipo	Obrigatório	Descrição
   Name	Entrada de texto	Sim	Nome exclusivo para o servidor MCP
   Transport method	Seleção	Sim	Streamable http (padrão), stdio ou SSE. Veja as diferenças na tabela a seguir.
   Input method	Seleção	Não	Manual Input (padrão) ou JSON Parse. Com JSON Parse, cole uma configuração JSON diretamente.

   Método de transporte	Conexão	Caso de uso
   http	Conecta-se a um servidor MCP remoto via http	Servidores MCP implantados em uma rede ou na cloud
   stdio	Inicia um processo local e comunica-se por entrada/saída padrão	Servidores MCP de linha de comando locais (como pacotes npm ou executáveis)
   SSE	Conecta-se a um service remoto via conexão persistente Server-Sent Events	Services remotos que ainda usam o protocolo SSE

   Forneça parâmetros de conexão diferentes dependendo do método de transporte selecionado:

   HTTP

   Parâmetro	Obrigatório	Descrição
   Server endpoint address	Sim	URL do endpoint Streamable http, como https://example.com/mcp
   Request Headers	Não	Um par KEY=VALUE por linha, como Authorization=Bearer xxxx
   Timeout	Não	Tempo limite de conexão em milissegundos. A dica da caixa de entrada é 30000. Insira um valor com base nas condições reais de rede.

   stdio

   Parâmetro	Obrigatório	Descrição
   Command	Sim	Comando de linha de comando para iniciar o service
   Arguments	Não	Argumentos de linha de comando (array de strings)
   Environment Variables	Não	Variáveis de ambiente (pares chave-valor)
   Timeout	Não	Tempo limite de conexão em milissegundos

   SSE

   Parâmetro	Obrigatório	Descrição
   URL	Sim	URL do endpoint SSE
   Request Headers	Não	Um par KEY=VALUE por linha
   Timeout	Não	Tempo limite de conexão em milissegundos

5. (Opcional) Ative Trust this service. Quando ativado, chamadas de ferramentas deste servidor não exigem confirmação em diretórios de trabalho confiáveis.

6. Clique em OK para criar o servidor. Após a criação, verifique na lista MCP Servers se a coluna status da nova entrada mostra Connected. Se mostrar Needs Auth, conclua a autenticação OAuth conforme instruído. Se mostrar Error, verifique o endereço, os parâmetros de transporte e a conectividade de rede e tente novamente.

Gerenciar servidores MCP existentes

As seguintes ações estão disponíveis para servidores MCP configurados:

Usar servidores MCP em uma tarefa

Na caixa de entrada de tarefas, insira @ e selecione MCP Resources para referenciar recursos do servidor MCP. O agente invoca as ferramentas externas e as fontes de dados fornecidas pelo servidor MCP ao executar tarefas.