Integração com ChatGPT

Conecte o ChatGPT à sua base de conhecimento aqoon usando GPTs Personalizados. Uma vez configurado, o ChatGPT pode pesquisar seus documentos e responder perguntas baseadas no conhecimento da sua organização.

Isso funciona com os planos ChatGPT Plus, Team e Enterprise.

Passo 1: Obter uma Chave de API

1. Vá para Chaves de API e crie uma nova chave
2. Escolha Acesso total (ou restrinja a coleções específicas)
3. Copie a chave — ela começa com aqn_ e não será exibida novamente

Passo 2: Criar um GPT Personalizado

1. Abra o ChatGPT
2. Clique no seu nome → Meus GPTs → Criar um GPT
3. Vá para a aba Configurar
4. Defina um nome, ex.: "Assistente de Conhecimento da Empresa"
5. Adicione instruções:

   You are a knowledge assistant for [Your Company]. When the user asks a question, use the searchKnowledge action to find relevant documents, then answer based on the results. Always cite which document the information came from.

Passo 3: Adicionar a Ação aqoon

1. Role para baixo até Ações → Criar nova ação
2. Defina Autenticação para Chave de API, tipo Bearer
3. Cole sua chave de API aqn_
4. Na caixa Schema, cole o seguinte schema OpenAPI:

openapi: 3.0.0
info:
  title: aqoon Knowledge Search
  description: Search your organization's knowledge base
  version: "1.0"
servers:
  - url: https://aqoon.ai
paths:
  /api/v1/search/:
    post:
      operationId: searchKnowledge
      summary: Search the knowledge base for relevant documents
      description: Returns document chunks matching the query, ranked by relevance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: The search query
                limit:
                  type: integer
                  description: Number of results (1-50)
                  default: 5
              required:
                - query
      responses:
        "200":
          description: Search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  count:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        content:
                          type: string
                        title:
                          type: string
                        document_id:
                          type: string
                        score:
                          type: number
  /api/v1/collections/:
    get:
      operationId: listCollections
      summary: List available collections
      description: Returns all collections the API key can access
      responses:
        "200":
          description: Collection list

5. Clique em Testar para verificar se a conexão funciona
6. Clique em Salvar (ou Publicar para compartilhar com sua equipe)

Passo 4: Use

Abra seu GPT Personalizado e faça uma pergunta sobre seus documentos:

• “Qual é nossa política de férias?”
• “Resuma o último relatório trimestral”
• “O que diz o artigo 12 do código trabalhista?”

O ChatGPT pesquisará sua base de conhecimento aqoon, recuperará documentos relevantes e responderá com citações.

Dicas

• Restrinja sua chave: Por segurança, crie uma chave de API restrita com acesso somente leitura a coleções específicas, em vez de usar uma chave de acesso total.
• Instruções do sistema: Seja específico sobre sua organização e que tipo de perguntas o GPT deve tratar. Isso ajuda o ChatGPT a formatar melhores prompts para a busca.
• Compartilhe com sua equipe: Publique o GPT Personalizado no seu workspace ChatGPT Team para que todos possam usá-lo.
• Atualize a URL do servidor: Se estiver usando uma instância auto-hospedada do aqoon, altere https://aqoon.ai no schema para a URL da sua instância.