Como criar um plugin pessoal
No Kimi Work, você pode usar a skill integrada Plugin Builder para transformar uma ideia de uma frase, um repositório externo de plugins ou qualquer página da web em um plugin seu. Seja qual for o método escolhido, o plugin chega até você pelo mesmo caminho: criar / converter → registrar no seu marketplace pessoal de plugins (a aba "Pessoal") → clicar em + para instalar → usar em uma conversa. Depois de instalado, ele fica disponível imediatamente na conversa atual — sem precisar reiniciar.
Antes de começar, verifique se você tem instalado o app de desktop do Kimi Work mais recente. O Plugin Builder é uma skill integrada e não precisa de instalação extra: digite "/" em uma conversa para invocá-lo ou clique em "Plugin personalizado" no marketplace de plugins para começar a criar na conversa principal.
Crie um plugin novo com uma frase
Ideal para o caso "tenho uma ideia, mas nenhum código existente". Você só precisa descrever a capacidade desejada; o Plugin Builder cuida automaticamente da estrutura inicial, do preenchimento dos campos, da validação local e do registro — você não escreve nenhum arquivo manualmente.
- Descreva o que você precisa. Invoque o Plugin Builder em uma conversa e explique em uma frase o que o plugin deve fazer — por exemplo, "crie para mim um plugin que consulte informações de registro de empresas". Os campos que podem ser inferidos, como nome, descrição e categoria, são preenchidos automaticamente; apenas as informações que não podem ser inferidas, como a URL de um servidor MCP ou um ícone, serão confirmadas com você.
- Aguarde a conclusão da criação. O Plugin Builder gera os arquivos do plugin localmente, passa automaticamente pela validação de estrutura e especificação e, em seguida, registra o plugin no seu marketplace pessoal de plugins.
- Instale e use. Abra Plugins → Pessoal, encontre o plugin que você acabou de criar e clique em + para instalar. Depois de instalado, ele fica imediatamente disponível na conversa atual e pode ser invocado a qualquer momento com "/".
Prompt de um parágrafo:
Importe plugins de um marketplace ou repositório
Envie um link de repositório de plugins ao Plugin Builder, e ele o reconhecerá automaticamente, converterá o formato e o instalará na sua aba "Pessoal". Os plugins importados não interferem no marketplace oficial e podem ser desinstalados a qualquer momento.
- Formatos de plugin compatíveis: o Plugin Builder reconhece manifestos de plugin das seguintes fontes e os converte todos para o formato nativo
kimi.plugin.jsondo Kimi:
| Formato | Observações |
|---|---|
kimi.plugin.json | Formato nativo do Kimi: os campos obrigatórios são corrigidos |
| Manifestos de plugin de outras plataformas de agentes | Como arquivos plugin.json em diretórios como .codex-plugin/plugin.json ou .claude-plugin/plugin.json, além dos arquivos de índice de marketplace distribuídos por essas plataformas |
server.json | O formato do registro oficial do MCP: convertido em um plugin que contém apenas um serviço MCP |
plugin.json genérico | Um manifesto genérico localizado no diretório raiz do plugin |
- Como importar: envie o link do repositório ao Plugin Builder. Ele reconhece automaticamente os seguintes formatos de repositório:
- Repositório de plugin único: todo o repositório é convertido em um plugin;
- Repositório com vários plugins (monorepo): cada subdiretório é convertido em seu próprio plugin;
- Repositório de marketplace / índice de plugins (um repositório com um índice plugins.json ou marketplace.json): cada entrada do índice é expandida e convertida em lote;
- Repositório somente de skills: um repositório sem manifesto de plugin, apenas com arquivos de skill, é empacotado como um plugin do tipo skill.
- Instale pela aba Pessoal: quando o processamento terminar, o Plugin Builder informa quais plugins estão utilizáveis. Vá em Plugins → Pessoal e clique em "Instalar" no cartão correspondente para começar a usá-lo nas conversas.
Prompts de um parágrafo:
Importar um único repositório:
Importar em lote um marketplace de plugins:
Converter apenas um subdiretório específico:
Como gerenciar os plugins importados:
- Atualizar um plugin: se o repositório de origem receber atualizações, ou se você quiser mudar o nome ou a descrição, basta avisar o Plugin Builder — ele fará a reconversão ou a modificação e registrará novamente.
- Desinstalar / remover: desinstale na aba "Pessoal" para desativar um plugin; a entrada permanece na aba após a desinstalação — exclua a entrada se quiser removê-la por completo.
- Diretório de origem: o resultado convertido fica no diretório plugins/ do seu workspace local. Ele contém os "arquivos de origem" do plugin, e o Plugin Builder baseia as atualizações futuras nele — não o exclua manualmente.
Transforme uma página da web em um plugin
Ideal para o caso "um site que uso com frequência não tem API pública, mas quero que o Kimi busque dados e opere o site para mim". Envie a URL ao Plugin Builder e descreva o que você precisa — por exemplo, "transforme o site XX em um plugin; quero pesquisar XX". Há duas opções de navegador para analisar o site e executar o plugin:
| Método | Ideal para | O que você precisa |
|---|---|---|
| Navegador integrado (padrão) | A maioria dos sites; usa o navegador integrado do Kimi Work para analisar o site e executar o plugin | Nada para instalar; quando o login for exigido, faça login uma vez no navegador integrado |
| WebBridge (wb) | Reutilizar contas em que você já está conectado no Chrome | Instale o WebBridge primeiro e use-o para controlar o seu Chrome |
- Analise o site. O Plugin Builder abre a URL no navegador escolhido. Se a página exigir login, ele pedirá que você faça login uma vez no navegador — nunca pede sua senha, cookies ou quaisquer credenciais.
- Engenharia reversa das APIs e geração do plugin. Ele opera de fato os recursos principais da página, captura as requisições de rede, descobre as APIs de dados internas do site e, em seguida, gera um plugin do tipo skill com scripts de consulta integrados.
- Valide, registre e instale. Assim como nos métodos anteriores: depois que o plugin passa na validação, ele é registrado na aba "Pessoal"; clique em + para instalar e começar a usar.
A partir daí, basta dizer "pesquise XX para mim", e o Kimi usa o plugin para buscar os dados diretamente no navegador e organizar os resultados. Se as APIs do site mudarem e o plugin parar de funcionar, peça ao Plugin Builder para reanalisar o site e atualizar o plugin.
Prompt de um parágrafo:
O método do navegador integrado depende da capacidade de navegador integrado do Kimi Work — se for solicitado que você atualize, atualize o app de desktop para a versão mais recente. O método WebBridge exige que o WebBridge esteja instalado primeiro no seu computador e no Chrome.
Este artigo foi útil?