Criar plugins

Transforme um fluxo de trabalho repetível num plugin, teste-o e refine-o no ChatGPT.

Transforme um fluxo de trabalho que repete num plugin que pode voltar a utilizar no ChatGPT. Descreva a tarefa numa conversa, adicione as instruções e o material de referência de que necessita e, depois, teste e refine o resultado.

O que é um plugin?

Um plugin é um pacote reutilizável que ajuda o ChatGPT a executar uma tarefa. Pode incluir apps, skills ou ambos.

As Apps ligam o ChatGPT a outros serviços. As Skills fornecem instruções para uma tarefa, como resumir um documento num formato consistente.

  • Encontrar um documento (app): Pesquise num serviço ligado um ficheiro a que tenha acesso.
  • Resumir um documento (skill): Transforme um documento que fornece numa visão geral, pontos-chave e questões em aberto.
  • Utilizar um modelo (skill): Organize as informações que fornece num formato padrão.
  • Comparar documentos (app + skill): Obtenha dois documentos a que pode aceder através de uma app permitida e, em seguida, compare-os utilizando a sua lista de verificação.

Os plugins podem ter o nome de um serviço, como Google Drive, ou de um fluxo de trabalho, como Document Summary. Consulte os detalhes do plugin para ver o que inclui.

Pode criar um plugin descrevendo o que precisa no ChatGPT. Os passos deste guia não exigem código.

Antes de começar

Estes passos abrangem o ChatGPT na Web quando a criação e edição de plugins estão ativadas no seu espaço de trabalho. Pode criar e editar através de uma conversa no Chat ou no Work.

Tenha em mente uma tarefa específica, um exemplo de um bom resultado e quaisquer ficheiros de referência que o plugin deva utilizar. Se precisar de uma app, confirme que a app é permitida no seu espaço de trabalho e conclua qualquer configuração de ligação necessária. Um plugin não lhe dá acesso adicional aos ficheiros, dados ou ações dessa app.

Utilizar um plugin

Utilize um plugin instalado no Chat ou no Work quando quiser que o ChatGPT siga o respetivo fluxo de trabalho ou utilize as suas apps. Selecione-o com uma menção @ para escolher o plugin para a sua tarefa.

  1. Inicie uma nova conversa no ChatGPT.
  2. Escreva @ na caixa de mensagem e, em seguida, comece a escrever o nome do plugin.
  3. Selecione o plugin em Plugins no menu.
  4. Descreva o que precisa, adicione quaisquer ficheiros relevantes e envie a sua mensagem.

O menu @ no ChatGPT Work mostra plugins e skills correspondentes. Selecione um plugin em Plugins.

Se o plugin precisar de uma ligação a uma app, siga os pedidos para a ligar. Para encontrar e instalar um plugin, consulte Plugins.

Criar um plugin de raiz

Comece com uma tarefa que realiza regularmente e um exemplo claro do resultado que pretende. O Plugin Creator ajuda a transformar essa descrição num fluxo de trabalho reutilizável através de uma conversa: pode explicar os passos, adicionar um modelo ou ficheiro de referência e refinar as instruções à medida que avança. O exemplo escrito abaixo utiliza um plugin Document Summary que transforma um documento numa visão geral, pontos principais e perguntas em aberto. Pode adaptar os mesmos passos a outra tarefa.

Esta gravação mostra um pedido inicial de plugin e a primeira resposta do Plugin Creator. Os exemplos escritos abaixo utilizam um fluxo de trabalho separado.

Passo 1: Mencionar o Plugin Creator

Inicie uma conversa no Chat ou no ChatGPT Work. Escreva @, procure Plugin Creator e selecione-o no menu.

Passo 2: Descrever o fluxo de trabalho

Um bom prompt de criação fornece ao Plugin Creator um resumo prático:

  • Finalidade: Identifique a tarefa recorrente e indique quando irá utilizar o plugin.
  • Dados de entrada: Descreva as informações que irá fornecer e como o plugin deve utilizar cada ficheiro anexado.
  • Resultado: Indique a quem se destina o resultado e especifique o formato, a extensão e o tom. Inclua um exemplo, se tiver algum.
  • Regras: Explique os passos obrigatórios, o que exige a sua revisão e como lidar com informações em falta. Por exemplo, fazer uma pergunta ou assinalar um campo como «não especificado».

Peça instruções que possa reutilizar com novas entradas. Mantenha os detalhes de uma tarefa individual, como um documento específico, identificados como exemplo para teste.

Criar um plugin de raiz:

Create a plugin called Document Summary. Summarize documents I provide in three sections: Overview, Key points, and Open questions. Use the attached template for the format. Base the summary only on the document. If requested information is missing, mark it as not provided. Do not edit the source document.

Passo 3: Adicionar contexto e refinar as instruções

Anexe um modelo, exemplo ou ficheiro de referência que o plugin deva utilizar. Responda às perguntas do Plugin Creator e peça alterações até as instruções corresponderem à tarefa. Se o fluxo de trabalho precisar de uma app, explique que parte da tarefa depende dela.

Mantenha a primeira versão focada num fluxo de trabalho. Um nome e uma descrição claros ajudarão a reconhecer quando a utilizar, tanto a si como aos seus colegas de equipa.

Passo 4: Rever e concluir a criação do plugin

Siga os prompts do Plugin Creator para concluir. Reveja o nome, a descrição, as instruções e o material de referência do plugin antes de depender dele.

Os novos plugins da área de trabalho começam como privados para que possa testá-los antes de os partilhar.

Incluir apps no seu plugin

As apps ligam o ChatGPT a outros serviços, como armazenamento de ficheiros ou ferramentas de gestão de projetos. Dependendo da app e das funcionalidades ativadas, o ChatGPT pode pesquisar ou ler informações e poderá conseguir executar ações, como criar um documento ou atualizar um registo. As Skills descrevem como fazer o trabalho; as apps fornecem as informações ou ações de que precisa.

As apps são opcionais. O Document Summary pode funcionar com texto que cole ou com um ficheiro que anexe. Inclua uma app se quiser que o fluxo de trabalho recupere um documento de outro serviço ou execute uma ação suportada nesse serviço.

Encontrar apps disponíveis para si

Navegue na área de trabalho onde planeia criar e utilizar o plugin:

  1. Abra Plugins no ChatGPT. Procure o serviço que pretende utilizar ou navegue no separador com o nome da sua área de trabalho.
  2. Abra os detalhes de um plugin e reveja a respetiva secção Apps. Um plugin pode ter o nome do serviço ao qual se liga, mas alguns plugins contêm apenas skills.
  3. Verifique as capacidades e o estado da ligação da app incluída. Siga os pedidos para Ligar quando necessário. Se apresentar Desativado pelo administrador ou Aprovação do administrador necessária, pergunte ao administrador da sua área de trabalho sobre o acesso.

Se a sua conta mostrar Apps em vez de Plugins, procure aí as ligações disponíveis. Ver um plugin no diretório não significa que todas as apps incluídas estejam prontas a utilizar.

Anote o nome da app e o que suporta e, em seguida, diga ao Plugin Creator como a pretende utilizar. Para mais informações sobre navegação e configuração, consulte Plugins.

Adicionar uma app ao seu fluxo de trabalho

Ao criar ou editar um plugin:

  1. Escolha uma app disponível. Utilize uma app que a sua área de trabalho permita e que tenha permissão para utilizar. Se não estiver disponível, pergunte ao administrador da sua área de trabalho sobre o acesso.
  2. Explique a sua função. Diga ao Plugin Creator que app incluir, que informações ler ou que ação executar, e o que pretende rever primeiro.
  3. Ligue e verifique. Siga quaisquer prompts de configuração e reveja as permissões pedidas. Poderá ter de iniciar sessão; algumas apps utilizam uma ligação gerida pelo administrador. Reveja as apps do plugin concluído e, em seguida, teste com informações a que já tenha acesso.

No exemplo abaixo, substitua [app name] por uma app permitida pela sua área de trabalho.

Incluir uma app:

Include [app name] in Document Summary, if it’s available to me. Read the document I link to and draft the Overview, Key points, and Open questions in chat. Keep the rule about marking missing information. Do not create or edit files in the app. If you cannot access the document, ask me to attach it.

Incluir uma app não concede novo acesso. As definições de apps e ações da sua área de trabalho, as permissões de ligação e o acesso no serviço de origem continuam a aplicar-se. Os colegas de equipa que utilizem o plugin também precisam do acesso à app e da configuração de ligação necessários.

Ligar um MCP server personalizado

Se nenhuma aplicação existente abranger o seu fluxo de trabalho, ligue as suas ferramentas com um MCP server personalizado. Utilize o Plugin Creator e o Sites para criar um plugin que se ligue ao seu sistema.

Testar o seu plugin

Instale o plugin se lhe for pedido e, em seguida, inicie uma nova conversa. Selecione-o com uma menção @ e dê-lhe uma tarefa familiar. Para o Document Summary, forneça um documento que conheça bem e peça um resumo.

Verifique se o resultado segue o seu formato, utiliza o material de referência correto e identifica informações em falta. Em seguida, experimente um documento com detalhes em falta ou pouco claros e verifique se o resumo identifica essas lacunas.

Se o plugin utilizar uma app, verifique se consegue aceder às informações ou ações de que a tarefa precisa. Se planeia utilizá-lo tanto no Chat como no Work, teste-o em cada um. As ferramentas e apps disponíveis podem diferir.

Guarde alguns prompts de exemplo para reutilizar depois de fazer alterações.

Teste antes de partilhar e repita as suas verificações depois de uma atualização.

Editar um plugin existente

Passo 1: Abrir o plugin para edição

Abra Plugins, selecione o plugin que pretende alterar e escolha Editar plugin. Isto abre uma conversa para o atualizar.

Passo 2: Descrever o que deve mudar

Um bom prompt de edição indica o comportamento ou ficheiro de referência a atualizar, descreve a alteração pretendida e identifica o que deve ser preservado. Se um resultado não correspondeu ao objetivo, inclua esse resultado e explique o que esperava. Peça um exemplo com entradas familiares para poder comparar o antes e o depois.

Indique claramente se pretende atualizar as instruções reutilizáveis do plugin ou rever um único resultado. Ao substituir um ficheiro de referência, indique o ficheiro antigo e explique como utilizar o novo.

Por exemplo, para alterar a saída:

Atualizar a saída:

Update Document Summary so Key points appears in a table with Point and Source columns. In Source, identify the supporting passage or section when available. Keep Overview, Open questions, and the rule about marking missing information. Show me a sample result from this document.

Para substituir material de referência:

Substituir material de referência:

Replace the existing summary template with the attached revised template. Keep the other reference files and instructions unchanged. Tell me what you changed, then help me test it with this document.

Passo 3: Rever a atualização

Reveja as instruções e os ficheiros revistos e, em seguida, siga os prompts para concluir a atualização. Confirme que as alterações solicitadas estão presentes e que a informação de que ainda precisa permanece intacta.

Passo 4: Testar novamente

Abra uma nova conversa e repita os prompts de teste guardados. Verifique o comportamento atualizado e as partes do fluxo de trabalho que pretendia preservar. Se outras pessoas utilizarem o plugin, peça a um colega de equipa para experimentar uma tarefa representativa antes de a equipa alargada depender da alteração.

Partilhar o plugin com a sua equipa

Quando o plugin estiver pronto, utilize as respetivas definições de partilha para escolher as pessoas ou grupos pretendidos. A partilha requer a permissão Partilhar plugins. Adicioná-lo ao diretório do espaço de trabalho requer a permissão Publicar plugins no espaço de trabalho.

A partilha e a instalação são processos separados. Os destinatários têm de instalar o plugin, salvo se um administrador já o tiver instalado por eles. Se o fluxo de trabalho utilizar uma app, cada pessoa também precisa do acesso necessário à app e de qualquer ligação de conta exigida pela app.

Inclua um prompt de exemplo com a ligação do plugin e informe os colegas de equipa sobre quem faz a sua manutenção. Consulte Plugins para saber mais sobre instalação e utilização.

Se não conseguir criar ou editar um plugin

Confirme que está no espaço de trabalho pretendido. Se a opção de criação ou o editor de plugins estiver em falta, peça ao administrador do espaço de trabalho para confirmar que a experiência está disponível e que tem o acesso necessário para a tarefa.

Se um colega de equipa conseguir abrir o plugin, mas não o conseguir utilizar, verifique separadamente a instalação do plugin, a permissão do espaço de trabalho para utilizar plugins e o acesso às apps necessárias. Os administradores podem rever os controlos de plugins.

Prosseguir para a documentação para criadores

Para integrações personalizadas ou desenvolvimento com ficheiros de plugins, consulte Empacotar o seu plugin. A documentação para programadores aborda a criação de skills e MCP servers, extensões, testes e submissão pública.

Para distribuição no espaço de trabalho através do GitHub, consulte Gestão de plugins.