Conector

O que é um conector de IA

Conector é uma integração entre uma aplicação e um serviço. No contexto de IA, ele pode permitir que o sistema consulte documentos, busque registros ou realize ações fora da conversa. A integração transforma recursos do serviço em operações que a aplicação consegue utilizar.

O termo não define sozinho uma tecnologia nem uma lista fixa de capacidades. Um conector pode oferecer somente leitura; outro, busca e edição. Alguns consultam a fonte durante a tarefa, enquanto outros mantêm um índice para facilitar a recuperação de conteúdo.

Para compreender uma integração, três perguntas ajudam: com qual serviço ela se comunica, quais operações disponibiliza e em nome de qual identidade trabalha. Essas respostas são mais úteis que presumir que “conectado” significa acesso completo.

Os elementos que participam da conexão

Uma integração reúne elementos com funções diferentes. O esquema deste verbete apresenta esses papéis de forma didática; os detalhes técnicos e as telas variam entre produtos.

• Aplicação de IA: recebe o pedido e utiliza os recursos disponíveis.
• Conector: implementa a integração e oferece operações sobre o serviço.
• Identidade: conta do usuário ou identidade de serviço sob a qual o acesso ocorre.
• Escopo e permissões: delimitam operações e recursos acessíveis, junto das regras da plataforma.
• Fonte: serviço em que os documentos ou registros são mantidos.
• Resultado: conteúdo, metadados, confirmação de ação ou indicação de que a operação não foi concluída.

Exemplo: consultar um briefing de projeto

Imagine uma arquiteta que pede: “Resuma as necessidades e pendências do briefing deste projeto”. O documento está guardado em uma pasta de trabalho. O exemplo é hipotético e serve para acompanhar a consulta, sem representar uma integração específica disponível no mercado.

A aplicação dispõe de um conector com capacidade de localizar e ler arquivos. A conta utilizada tem acesso à pasta Projeto e a consulta foi autorizada nesse contexto. A operação encontra o briefing, obtém as informações permitidas e devolve material para a elaboração do resumo.

A entrega deve identificar o documento utilizado e separar o que ele confirma das questões em aberto. Consultar um briefing não equivale a aprová-lo. Se o texto registra uma preferência ainda não validada, o resumo precisa preservar essa condição.

Quando o documento está fora do escopo

No segundo cenário, o pedido aponta para um documento fora da área autorizada. O conector continua configurado, mas isso não torna o arquivo acessível. A integração deve respeitar as regras aplicáveis e não devolver conteúdo que a identidade utilizada não pode consultar.

A resposta informa apenas a limitação que o sistema consegue sustentar: a operação não disponibilizou o documento. Dependendo do serviço, a aplicação pode não conseguir distinguir falta de permissão, arquivo inexistente e recurso indisponível. Não deve inventar uma causa específica.

O desenho conhece o escopo do exemplo para tornar essa diferença visível. Em uso real, o agente não deve revelar o nome ou o conteúdo de arquivos protegidos que a aplicação não forneceu. A próxima ação pode ser conferir a conta e o escopo ou pedir uma cópia que o usuário possa compartilhar.

Identidade, autenticação e permissão

Autenticação ajuda a estabelecer qual identidade está acessando o serviço. Autorização determina o que essa identidade pode fazer. Concluir uma conexão de conta não garante que todos os arquivos daquela organização estejam disponíveis.

O acesso efetivo pode depender das permissões do usuário, dos escopos concedidos à integração, das configurações de administração e das regras de compartilhamento do documento. Algumas integrações utilizam uma identidade de serviço, cujo alcance precisa ser entendido separadamente.

No escritório, vale confirmar se a consulta ocorre com a conta da arquiteta ou com uma conta configurada pela organização. Essa diferença influencia os documentos disponíveis e a forma de revisar o acesso. A interface da conversa não substitui essa configuração.

Consulta no momento do pedido e conteúdo indexado

Na consulta sob demanda, uma operação busca informações no serviço durante a tarefa. Isso não impede a existência de caches nem garante, por si só, que todos os sistemas envolvidos estejam atualizados. É necessário entender o comportamento oferecido pelo produto.

Em outra abordagem, a integração sincroniza conteúdo e cria ou alimenta um índice usado nas buscas. O pedido pode recuperar informações desse índice, sem consultar novamente cada documento original. Essa organização pode facilitar a busca, mas introduz questões de cobertura e atualização.

As duas abordagens podem coexistir. Um sistema pode pesquisar um índice e depois abrir um documento na fonte. Conector não é sinônimo de indexação, e a presença de uma integração não permite presumir qual dessas operações foi realizada.

Como avaliar a atualização das informações

Suponha que o briefing tenha sido alterado após uma reunião. Um resumo baseado em conteúdo antigo pode apresentar como pendente uma decisão já registrada. Antes de usar a entrega, a equipe precisa conferir qual documento ou versão foi consultado e quais indicações de atualização estão disponíveis.

Data de modificação do arquivo, data da última sincronização e horário da consulta descrevem acontecimentos diferentes. Uma consulta recente a um índice não prova que a revisão mais recente do documento já entrou nesse índice.

Para tarefas em que uma mudança recente faz diferença, confirme a fonte e a versão. Se a aplicação não informa esses elementos, registre a limitação e confira o arquivo no serviço original. Não invente um prazo universal de sincronização para todos os conectores.

Leitura e escrita são capacidades diferentes

Uma integração capaz de ler o briefing pode não oferecer edição. Mesmo que ofereça, a identidade utilizada pode ter apenas acesso de leitura. Capacidade implementada, permissão disponível e instrução do usuário precisam ser consideradas em conjunto.

Pedir um resumo é diferente de pedir a atualização do arquivo original. Preparar uma sugestão de texto na conversa não comprova que o documento foi alterado. A aplicação só deve declarar a conclusão de uma mudança quando dispõe de confirmação da operação.

No exemplo, o resultado é um resumo para revisão. Acrescentar uma pendência ao arquivo, compartilhar a pasta ou enviar o documento envolveria outras operações, com condições próprias. Não se deve inferir autorização para essas ações a partir do pedido de consulta.

Conector, MCP, plugin e ferramenta

MCP é um protocolo para a comunicação entre aplicações de IA e recursos externos. Um conector pode utilizá-lo, mas também pode integrar um serviço por outros mecanismos. API descreve a interface pela qual programas trocam solicitações e respostas; não é sinônimo da integração inteira.

Plugin é uma extensão de aplicação que pode reunir vários componentes, inclusive configurações de integração. Ferramenta é uma operação disponível, como buscar arquivos ou ler um documento. O conector pode oferecer mais de uma ferramenta ligada ao mesmo serviço.

No exemplo, a integração conecta a fonte de documentos, a ferramenta executa a consulta e o modelo trabalha sobre as informações recebidas. Disponibilizar esse acesso não altera por si só os pesos do modelo nem significa treiná-lo com toda a pasta.

O que a conexão não garante

Encontrar um documento não garante que ele seja o correto para o pedido. Podem existir cópias, nomes parecidos e versões antigas. A leitura também pode ser parcial ou falhar em tabelas e outros elementos, conforme o formato e o recurso utilizado.

Além disso, conteúdo disponível não é necessariamente confiável ou suficiente. O agente pode interpretar mal um trecho ou ignorar uma ressalva. Por isso, origem identificável, limites explícitos e revisão continuam relevantes depois que a conexão funciona.

O conector resolve uma parte do acesso e da operação. A seleção das fontes, a qualidade do documento e o uso das informações na resposta pertencem ao trabalho completo.

Como testar a integração antes de adotá-la

Como proposta editorial deste glossário, comece com documentos de teste que a equipe conhece. Use um briefing acessível, um documento fora do escopo e uma versão atualizada. Esses casos permitem observar acesso, limites e atualização sem depender de uma demonstração idealizada.

• Identifica a fonte utilizada e devolve o conteúdo esperado?
• Respeita o escopo e explica indisponibilidades sem inventar consultas?
• Permite distinguir dados atuais de versões anteriores?
• Separa funções de leitura e de alteração?
• Apresenta confirmação verificável quando executa uma ação?
• Continua consistente após mudanças de permissão e desconexão da conta?

Manutenção e retirada do acesso

Uma conexão precisa acompanhar mudanças na equipe e nos projetos. Contas desativadas, arquivos movidos e permissões revistas podem alterar o comportamento da integração. Convém definir quem acompanha essas configurações e resolve falhas recorrentes.

Ao desconectar uma conta, verifique o tratamento das autorizações, dos índices e dos dados já copiados ou produzidos. Retirar a conexão não deve ser interpretado automaticamente como excluir respostas anteriores ou arquivos exportados. Essas condições dependem do serviço e da aplicação.

Um conector bem utilizado oferece acesso adequado ao trabalho, limites compreensíveis e resultados conferíveis. Para o escritório, o objetivo é consultar o briefing certo, nas condições autorizadas, e saber o que ainda exige verificação.