Criar Base de Conhecimento IA

Ao incluir uma Base de Conhecimento em um modelo do Marketplace de Agentes de IA, os criadores de modelos podem empacotar conteúdo de origem útil junto com o agente. Isso é útil quando o agente precisa de perguntas frequentes, detalhes do serviço, políticas, documentação ou informações específicas do setor para responder com precisão.

Os compradores podem instalar um modelo mais completo e, em seguida, revisar e personalizar a Base de Conhecimento para seus próprios negócios antes de publicá-la.

O que é o agrupamento de bases de conhecimento para modelos do Marketplace de agentes de IA?

Agrupar uma Base de Conhecimento significa incluir conteúdo selecionado da Base de Conhecimento com um modelo do Marketplace de Agentes de IA durante o processo de publicação. Quando o modelo é instalado, o comprador pode receber o agente e o conteúdo da Base de Conhecimento que o acompanha, dependendo dos recursos incluídos no pacote do modelo.

Isso é especialmente útil para agentes que dependem de conteúdo de fontes confiáveis, como agentes de suporte, agentes de atendimento, assistentes de políticas, assistentes de vendas e agentes que trabalham com documentação. A Base de Conhecimento incluída ainda deve ser revisada e testada após a instalação para confirmar se atende às necessidades de negócios do comprador.

Principais benefícios do agrupamento de bases de conhecimento

A inclusão de bases de conhecimento ajuda os criadores de modelos a oferecer experiências mais completas para agentes de IA. Em vez de pedir aos compradores que recriem todo o conteúdo original manualmente, os vendedores podem incluir conhecimento reutilizável que dê suporte ao caso de uso pretendido do agente.

• Retorno sobre o investimento mais rápido: as agências começam com respostas prontas para uso em vez de criar conteúdo do zero.
• Respostas mais inteligentes e prontas para uso: os agentes baseiam suas respostas em artigos, arquivos e dados agrupados.
• Integração padronizada: cada instalação recebe referências consistentes e de alta qualidade.
• Modelo como ferramenta de ensino: a base de conhecimento funciona também como um guia instrucional que as agências podem substituir por seu próprio conteúdo.
• Redução da carga de suporte: exemplos pré-carregados diminuem as dúvidas de configuração.
• Controle de qualidade escalável: os desenvolvedores controlam a estrutura, a nomenclatura e o conteúdo de fácil recuperação desde o início.

Quando agrupar uma base de conhecimento

Uma Base de Conhecimento deve ser incluída quando o valor do agente depender de conteúdo de referência específico. Se o agente só tiver um bom desempenho quando puder recuperar respostas, políticas ou documentação conhecidas, inclua a Base de Conhecimento durante a publicação.

Inclua uma Base de Conhecimento quando:

• O agente responde às perguntas frequentes.
• O agente utiliza informações sobre serviços, produtos ou políticas.
• O agente precisa de conteúdo específico do setor.
• O agente presta suporte aos fluxos de trabalho de atendimento ao cliente, vendas, integração, recebimento de solicitações ou documentação.
• O agente utiliza a ferramenta Base de Conhecimento no Agent Studio.
• O modelo foi projetado para respostas de IA de voz com suporte de conteúdo da Base de Conhecimento.
• O comprador deve receber o conteúdo original juntamente com o fluxo ou a configuração do agente.

Para agências: Instalação e personalização de uma base de conhecimento integrada

As agências recebem uma Base de Conhecimento pré-carregada com determinados modelos do Marketplace. Estas etapas ajudam você a instalar, encontrar, personalizar e validar a Base de Conhecimento para que seu agente forneça respostas precisas e alinhadas à marca rapidamente.

Instale e localize a Base de Conhecimento incluída

Personalizar e substituir conteúdo

• Faça edições seguras: Duplique uma pasta antes de fazer alterações significativas para que você possa reverter o processo.
• Substitua marcadores de posição rapidamente: Pesquise por marcadores como {{Marca}}, {{Telefone}}, {{URL}} e atualize-os em todos os artigos.
• Adicione seus documentos: faça upload de políticas, perguntas frequentes e fichas técnicas de produtos. Dê preferência a fontes com texto como primeiro elemento para facilitar a recuperação da informação.
• Recuperação de pontos de referência, se necessário: Se você criou novas pastas, atualize o nó da Base de Conhecimento do agente para incluir as novas pastas/tags no AI Agent Studio.

Pós-instalação: Onde as agências encontram e gerenciam a base de conhecimento integrada

As agências devem saber onde o conteúdo importado está armazenado, como adaptá-lo e como manter o agente informado sobre as fontes corretas.

• Localização: Navegue até Ferramentas de IA → Base de Conhecimento para ver as pastas e artigos adicionados recentemente, marcados com o nome do modelo ou um carimbo de data/hora.
• Edição: Abra qualquer artigo para personalizar o texto, substituir nomes de marcas e atualizar exemplos. As alterações entram em vigor imediatamente para a recuperação de informações pelo agente.
• Substituindo o conteúdo do modelo: Adicione documentos específicos da sua empresa às mesmas pastas ou crie novas pastas e redirecione a recuperação (caso seu agente utilize nós ou filtros específicos da base de conhecimento).
• Remova ou arquive os exemplos de modelos assim que migrar o conteúdo real.
• Vinculação ao Agente: Confirme se o nó da Base de Conhecimento do agente (ou as configurações de recuperação) inclui as pastas/tags desejadas para que o agente faça referência ao seu conteúdo atualizado.

Melhores práticas para agências (adoção de uma base de conhecimento agrupada)

• Duplique as pastas importadas e, em seguida, adapte o conteúdo sem perder o conjunto de referência original.
• Substitua imediatamente os espaços reservados (nomes de marcas, ofertas, detalhes de contato).
• Adicione primeiro as perguntas frequentes mais relevantes, as políticas e os preços — esses são os elementos que mais contribuem para a qualidade das respostas.
• Mantenha arquivos grandes dentro dos limites de tamanho e prefira fontes com texto como primeiro elemento para melhor recuperação da informação.
• Após as edições, converse com o agente e verifique se as respostas citam os artigos esperados.

Para desenvolvedores de agentes: Publicação com uma base de conhecimento integrada

Os desenvolvedores podem anexar a Base de Conhecimento associada ao publicar no Marketplace. Essas etapas garantem que o conteúdo correto seja incluído e que as agências recebam uma cópia funcional e editável na instalação.

Incluir a Base de Conhecimento durante a Publicação no Marketplace

Melhores práticas para desenvolvedores de agentes (criando bases de conhecimento para modelos)

Uma base de conhecimento (KB) bem estruturada e baseada em modelos ensina às agências como ter sucesso, ao mesmo tempo que permite a fácil substituição por dados reais.

• Organize o conteúdo em pastas claras (por exemplo, "Primeiros passos", "Perguntas frequentes sobre o produto", "Exemplos de preços").
• Utilize títulos descritivos para os artigos que correspondam às perguntas mais prováveis dos usuários.
• Adicione espaços reservados para nomes de marcas, URLs e preços para que as agências possam identificar e substituir rapidamente.
• Dê preferência a uma escrita concisa e de fácil consulta — parágrafos curtos, títulos e listas.
• Inclua um breve artigo "Comece Aqui" com links para as peças principais.
• Remova qualquer material proprietário ou confidencial antes da publicação.
• Teste o agente usando apenas a base de conhecimento incluída para garantir respostas de qualidade logo após a instalação.

Escopo e comportamento do pacote

Saiba exatamente o que está incluído no pacote, o que é copiado para a conta de instalação e como essa cópia se comporta ao longo do tempo.

• Modelo de cópia: O conteúdo da Base de Conhecimento incluído é copiado para a conta da agência que realiza a instalação durante a instalação do modelo. As edições feitas pela agência não afetam a sua Base de Conhecimento original.

O que está incluído:

• Pastas e artigos da Base de Conhecimento (páginas de texto formatado) anexados ao agente.
• Anexos de arquivos suportados (por exemplo, PDFs, imagens) que pertencem às pastas incluídas.
• Tabelas/recursos CSV usados para recuperação (se fizerem parte da base de conhecimento).
• Links treinados (URLs da web) e seu conteúdo indexado atual.

O que não está incluído: Itens específicos da conta que não podem ser transferidos (por exemplo, integrações privadas ou credenciais). Substitua por marcadores de posição nos modelos.

• Atualizações após a publicação: as alterações futuras feitas na sua Base de Conhecimento original não serão sincronizadas automaticamente com as agências que já instalaram o modelo. Lance uma nova versão do modelo ou forneça um pacote de atualização de conteúdo se desejar que as agências recebam as revisões.
• Proteção contra duplicados: Se uma agência instalar vários modelos com pastas KB de nomes semelhantes, o sistema criará cópias separadas para evitar conflitos. As agências podem mesclar ou renomear as pastas após a instalação.