Deploy a C# Pesquisa de IA do Azure app to Azure Container Apps

Note

O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.

Implemente o site habilitado para pesquisa no Azure Container Apps usando o Azure Developer CLI (azd). Esta implementação inclui o cliente React, a API .NET, Pesquisa de IA do Azure, identidade gerida e recursos Azure de suporte.

A implementação utiliza identidade gerida como método de autenticação predefinido para o Pesquisa de IA do Azure. Pode optar pela autenticação baseada em chaves definindo USE_KEYLESS_AUTH para false antes da implementação.

Iniciar sessão no Azure

  1. No Visual Studio Code, abre um terminal na raiz do repositório, como azure-search-static-web-app.

  2. Inicie sessão no Azure usando azd.

    azd auth login

  3. Se for solicitado pelo seu navegador, complete o processo de início de sessão usando a conta do Azure que está a usar para este tutorial.

Criar um ambiente azd

  • Crie um azd ambiente. Substitua YOUR-ENVIRONMENT-NAME por um nome curto que identifique esta implementação do tutorial.

    azd env new YOUR-ENVIRONMENT-NAME

(Opcional) Configurar autenticação baseada em chaves

O método de autenticação por defeito é a identidade gerida, pelo que a maioria dos ambientes pode saltar esta secção. Complete esta secção apenas se o seu ambiente exigir chaves de API.

Defina USE_KEYLESS_AUTH como false.

azd env set USE_KEYLESS_AUTH false

Se não definires USE_KEYLESS_AUTH, a implementação usa identidade gerida. A infraestrutura do Bicep concede à identidade da aplicação contentor acesso ao plano de dados do Pesquisa de IA do Azure.

Deploy com azd up

  1. A partir do diretório raiz do repositório, execute azd up.

    azd up

  2. Quando solicitado, selecione a subscrição do Azure e a localização dos recursos.

  3. Espere para azd provisionar a infraestrutura, construir os containers, enviar as imagens e implementar os serviços para o Azure Container Apps.

  4. Revise a saída após a implementação. O resultado inclui os nomes de domínio totalmente qualificados (FQDNs) do cliente e servidor para a implementação do Azure Container Apps.

    AZURE_CLIENT_URL: <client-container-app-fqdn>
AZURE_SERVER_URL: <server-container-app-fqdn>
SEARCH_SERVICE_NAME: <search-service-name>

    Use o AZURE_CLIENT_URL valor para abrir o site. A aplicação cliente chama a aplicação do servidor através do endpoint configurado durante a implementação.

    A implementação também criou o serviço Pesquisa de IA do Azure e carregou automaticamente o good-books índice através do postprovision hook no repositório de exemplos.

Use a pesquisa no seu site Container Apps

  1. Abra o FQDN do cliente a partir da azd up saída num navegador.

  2. Na barra de pesquisa do site, introduza uma consulta de pesquisa, como code. A funcionalidade de autocompletar sugere títulos de livros correspondentes.

  3. Selecione uma sugestão ou continue a introduzir a sua própria consulta. Selecione Enter quando terminar a sua consulta.

  4. Veja os resultados e depois selecione um livro para ver mais detalhes.

Troubleshooting

Se a aplicação web não for implementada ou funcionar, use a seguinte lista para determinar e resolver o problema:

  • Terminou azd up ?

    Rever o azd up resultado do primeiro passo falhado de provisionamento, build ou deploy. Se a implementação parar durante o provisionamento, verifique as permissões de subscrição e a região selecionada. Se a implementação parar durante a construção ou implementação do contentor, volte a executar azd up depois de corrigir o problema reportado.

  • Consegues abrir o endpoint do cliente?

    Abre o AZURE_CLIENT_URL valor da azd up saída. Se a página não carregar, vai ao portal do Azure, abre a aplicação do cliente e vê o estado da revisão e os registos.

  • O cliente consegue ligar ao endpoint do servidor?

    Abra as ferramentas de desenvolvimento do seu navegador e reveja as chamadas de rede da aplicação cliente. Se as chamadas para a API falharem, confirme que a aplicação contentor do servidor está a correr e que a aplicação cliente recebeu o FQDN do servidor durante a implementação.

  • O servidor pode consultar o Pesquisa de IA do Azure?

    Se as pesquisas devolverem erros, reveja os registos da aplicação do contentor do servidor. Para identidade gerida, confirme que a identidade tem acesso ao plano de dados do Pesquisa de IA do Azure. Para autenticação baseada em chaves, confirme que definiu USE_KEYLESS_AUTH como false antes da implementação e que o ambiente do contentor gerado contém a configuração do serviço de pesquisa.

Limpeza de recursos

Use azd down --purge para apagar os recursos do Azure que este tutorial criou. A --purge flag remove permanentemente os recursos que suportam a eliminação suave, em vez de os deixar num estado recuperável durante o período de retenção. Purgar evita conflitos de nomes se voltares a implementar este tutorial mais tarde.

  1. A partir da raiz do repositório, execute o comando de limpeza.

    azd down --purge

  2. Revise os recursos que azd listam.

  3. Confirme a eliminação quando solicitado.

Se criou um serviço Pesquisa de IA do Azure fora da azd implementação, vá ao seu serviço de pesquisa no portal Azure e selecione Eliminar no topo da página.

Passo seguinte

Explore o código de integração de pesquisa

  • Last updated on