Partilhar via

Projetar e desenvolver APIs usando o plug-in do Centro de API para o GitHub Copilot para Azure

O plug-in do Centro de API do GitHub Copilot para Azure acelera o design e o desenvolvimento de novas APIs a partir de prompts de linguagem natural. Com a assistência de IA disponível através do plug-in do Centro de API combinado com a extensão VS Code do Centro de API, basta descrever sua API e gerar rapidamente uma especificação OpenAPI para desenvolvimento de API que esteja em conformidade com os padrões da sua organização. Depois de gerar uma especificação compatível, você pode registrar a API com seu centro de API.

Pré-requisitos

Configuração da extensão

Configure a extensão seguindo estes passos:

  1. Instale a extensão do Centro de API do Azure para Visual Studio Code a partir do Visual Studio Code Marketplace. Instale outras extensões conforme necessário.

    Nota

    A [PREVIEW] notação indica as funcionalidades disponíveis apenas na versão pré-lançamento da extensão Azure API Center. Quando instala a extensão no Visual Studio Code Marketplace, pode optar por instalar a versão de lançamento ou uma versão pré-lançamento (conforme disponível). Para alternar entre versões instaladas, selecione o botão Gerenciar da extensão (ícone de engrenagem) na vista Extensões no Visual Studio Code.

  2. No Visual Studio Code, na barra de Atividades, selecione Centro de API:

    Captura de ecrã do ícone da extensão do API Center na barra de atividades Visual Studio Code.

  3. Se não tiver sessão iniciada na sua conta Azure, selecione Iniciar sessão no Azure e siga as instruções para iniciar sessão.

  4. Selecione uma subscrição Azure com o centro de API (ou centros de API) que tenha as APIs que quer ver. Se tiveres várias contas, podes filtrar por subscrições específicas.

Fazer pedido ao @azure agente

Siga estas etapas para gerar uma especificação OpenAPI usando prompts de linguagem natural com o GitHub Copilot for Azure:

  1. Se desejar, defina um guia de estilo de API ativo na extensão do Centro de API do Azure. Use o atalho de teclado Ctrl+Shift+P para abrir a Paleta de Comandos. Digite Central de API do Azure: defina o Guia de Estilo da API, faça uma seleção e pressione Enter.

    Se nenhum guia de estilo for definido, o conjunto de regras padrão spectral:oas será usado. Saiba mais sobre análise de especificação de API usando a extensão do Centro de API.

  2. No painel de chat, faça uma solicitação em linguagem natural ao @azure agente para descrever o que a API faz. Exemplo:

    @azure Generate an OpenAPI spec: An API that allows customers to pay for an order using various payment methods such as cash, checks, credit cards, and debit cards. Check that there are no duplicate keys.

    O copiloto é alimentado por IA, por isso surpresas e erros são possíveis. Para obter mais informações, consulte Perguntas frequentes sobre o Copilot.

    O agente responde com um documento de especificação OpenAPI.

    Captura de tela mostrando como usar @azure extensão para gerar uma especificação OpenAPI a partir de um prompt.

  3. Analise a saída gerada para verificar se há precisão, integridade e conformidade com o guia de estilo da API.

    Refine o prompt, se necessário, para regenerar a especificação ou repita o processo usando um guia de estilo diferente definido na extensão do Centro de API do Azure.

    Gorjeta

    Os prompts eficazes se concentram nos requisitos de negócios de uma API, em vez de nos detalhes da implementação. Por vezes, prompts mais curtos funcionam melhor do que os mais longos.

  4. Quando atender aos seus requisitos, guarde a especificação OpenAPI gerada num ficheiro.

Registre a API em seu centro de API

Use a extensão do Centro de API do Azure para VS Code para registrar a API em seu centro de API a partir do arquivo de especificação gerado. Depois de registrar a API, você pode usar a extensão para visualizar a documentação da API, gerar um cliente HTTP, executar forros e análises adicionais e muito mais.

  1. No VS Code, selecione o botão Registrar sua API na Central de APIs no painel de chat ou selecione Central de API do Azure: Registrar API na Paleta de Comandos.

  2. Selecione Manual.

  3. Selecione o centro de API com o qual registrar APIs.

  4. Responda aos prompts com as informações, incluindo o título da API, o tipo, o título da versão, o ciclo de vida da versão da API, o título da definição, o nome da especificação e o arquivo de definição (especificação) para concluir o registo da API.

Depois que a API é registrada, você pode executar várias tarefas usando a extensão. Por exemplo, veja a documentação da API na interface do usuário do Swagger:

  1. Expanda a visualização em árvore do Centro de API para selecionar a definição para a versão da API que você registrou.

  2. Clique com o botão direito do mouse na definição e selecione Abrir documentação da API. Uma nova guia aparece com a interface Swagger para a definição da API.

Captura de tela da interface do usuário do Swagger na extensão VS Code.

Conteúdos relacionados

  • Last updated on