Disponibilize o Anywhere

Este guia é para o responsável técnico pela implantação. A entrega do Anywhere inclui o ambiente da plataforma, o Gateway e o canal de instalação da extensão. O Gateway e o acesso à conta pertencem ao produto Anywhere. As aplicações de origem são disponibilizadas por integrações próprias; o Zendesk é a primeira implementação disponível. Para a instalação no navegador, encaminhe ao usuário Instale e mantenha o Anywhere.

Componentes necessários

Componente	Responsabilidade
Extensão do Chrome	Painel, leitura do contexto e ações disponibilizadas pela integração
Gateway	Autenticação da extensão, verificação de acesso e encaminhamento das operações
Identity	Login Strattum, renovação de credenciais e vínculos individuais com fontes
Applications Runtime	Execução da IA e histórico das conversas
Catalog, Memory e Skills	Descoberta das aplicações e consultas que sustentam as fichas conforme a ontologia do cliente
Fontes sincronizadas	Registros, conteúdos e relacionamentos das aplicações disponibilizadas
PostgreSQL	Dados de operação dos serviços e preferências do usuário

O serviço de IA precisa estar configurado com o modelo e as ferramentas do ambiente. A extensão recebe apenas o endereço do Gateway para sua conexão inicial.

Prepare a instalação da plataforma

Use a instalação da plataforma adequada ao ambiente. No Starter, o serviço strattum-anywhere-gateway é publicado por HTTPS no endereço https://anywhere.<dominio-da-instalacao>.

Configure o DNS desse endereço para a instalação.
Confira o certificado HTTPS e o acesso pela rede dos usuários.
Prepare Identity, Applications Runtime e banco de dados.
Disponibilize as fontes e os acessos descritos em Gerencie acessos e fontes.

As instruções de instalação da plataforma cobrem o provisionamento inicial. As etapas seguintes tratam da configuração do Anywhere nesse ambiente.

Ative os serviços no Starter

No Starter, ANYWHERE_ENABLED é a opção técnica de ativação do Gateway. Ela começa em false nos valores padrão do mecanismo de implantação.

Valor	Efeito
`true`	Inclui o Gateway e o serviço de IA na seleção de serviços da implantação
`false`	Não inclui o perfil do Gateway por essa opção

O valor true exige o identificador e os endereços de retorno do cliente de autenticação preenchidos. A configuração deve entrar na fonte de configuração da implantação, para ser preservada nas atualizações.

Exemplo de endereços

O exemplo usa o domínio fictício empresa.example. Substitua-o pelo domínio da instalação.

ANYWHERE_ENABLED=true
GATEWAY_PUBLIC_URL=https://anywhere.empresa.example
OAUTH_ANYWHERE_CLIENT_ID=strattum-anywhere
OAUTH_ANYWHERE_REDIRECT_URIS=https://anywhere.empresa.example/v1/auth/callback,https://anywhere.empresa.example/v1/slack/connect/identity/callback,https://anywhere.empresa.example/v1/slack/connections/identity/callback
ANYWHERE_OIDC_REDIRECT_URI=https://anywhere.empresa.example/v1/auth/callback
ANYWHERE_LINK_RETURN_URL=https://anywhere.empresa.example/v1/links/return

OAUTH_ANYWHERE_REDIRECT_URIS é uma lista compartilhada pelo Anywhere e pelo App do Slack. O primeiro endereço é o retorno do Anywhere; os dois seguintes são usados pelo Slack na conexão da conta. Ao editar a lista, preserve os endereços já registrados. Substituir a lista apenas pelo retorno do Anywhere interrompe a conexão de conta pelo Slack. No Starter gerenciado por Terraform, os retornos do Slack são acrescentados automaticamente.

Configure a autenticação

O Gateway usa um cliente próprio no Identity. O endereço de retorno precisa corresponder exatamente a um endereço registrado, incluindo protocolo, domínio e caminho.

Configuração	Onde	Regra
`OAUTH_ANYWHERE_CLIENT_ID`	Identity / configuração da implantação	Identificador próprio do cliente, como `strattum-anywhere`
`OAUTH_ANYWHERE_REDIRECT_URIS`	Identity / configuração da implantação	Lista de endereços de retorno exatos; use `/v1/auth/callback` no Gateway
`ANYWHERE_OIDC_CLIENT_ID`	Gateway	Mesmo identificador registrado no Identity; o Starter o recebe do campo anterior
`ANYWHERE_OIDC_REDIRECT_URI`	Gateway	Um dos endereços registrados no Identity
`ANYWHERE_OIDC_CLIENT_SECRET`	Gateway, quando configurado diretamente	Vazio para esse cliente público, que usa proteção por código de verificação
`ANYWHERE_OIDC_ISSUER`	Gateway	Endereço de descoberta publicado pelo Identity; no Starter, deriva de `OAUTH_PUBLIC_URL`
`ANYWHERE_JWKS_URL`	Gateway	Endereço das chaves públicas usado para conferir credenciais
`ANYWHERE_JWT_ISSUER` / `ANYWHERE_JWT_AUDIENCE`	Gateway	Mesmos valores de emissor e destinatário utilizados pela plataforma
`ANYWHERE_LINK_RETURN_URL`	Identity / implantação	Retorno da vinculação individual das fontes para o Gateway

O endereço público de descoberta e o emissor gravado na credencial são configurações distintas. Copie os valores da instalação; preserve a correspondência entre Identity, Gateway e serviço de IA. Registre o cliente pelos campos próprios OAUTH_ANYWHERE_* do Identity. O cadastro genérico de um cliente com o mesmo nome não substitui essa configuração.

Confira as conexões entre serviços

Configuração do Gateway	Obrigatoriedade	Finalidade
`ANYWHERE_RUNTIME_URL`	Obrigatória	Endereço interno do serviço de IA para geração e conversa
`ANYWHERE_PG_DSN`	Necessária para os dados de operação	Conexão do Gateway ao banco com seu usuário dedicado
`ANYWHERE_IDENTITY_API_URL`	Necessária para vínculos e descoberta de acesso	Consulta das fontes disponíveis para cada pessoa
`ANYWHERE_SERVICE_API_KEY`	Necessária nas chamadas de serviço protegidas	Credencial de serviço mantida no ambiente do Gateway
`ANYWHERE_CATALOG_API_URL`	Necessária para descoberta pela plataforma	Consulta das aplicações e contas disponíveis
`ANYWHERE_MEMORY_API_URL` e `ANYWHERE_SKILLS_API_URL`	Necessárias para as fichas contextuais	Consultas estruturadas conforme a ontologia e a aplicação de origem
`ANYWHERE_ENVIRONMENT_ID`	Opcional no serviço	Identificador do ambiente
`ANYWHERE_ENVIRONMENT_NAME`	Opcional no serviço	Nome apresentado ao usuário na conexão

Os endereços internos são configurações dos serviços. Para o usuário, entregue o endereço público HTTPS do Gateway. Ao configurar o serviço diretamente, mantenha credenciais no mecanismo de segredos do ambiente. Os campos opcionais do serviço só entram no processo quando a definição de implantação os encaminha.

Aplique e confira a implantação

Para um Starter já instalado, use o fluxo de atualização da plataforma. Na máquina da instalação, substitua SUA_TAG_DA_PLATAFORMA pela versão que será aplicada:

strattumctl plan SUA_TAG_DA_PLATAFORMA

Revise o plano, os serviços selecionados e as configurações. Depois, aplique o plano revisado:

strattumctl apply
strattumctl status

O provisionamento inicial segue o processo de instalação da plataforma. strattumctl plan e apply tratam da atualização da instalação existente.

Verifique a identificação pública

curl --fail https://anywhere.empresa.example/v1/installation

Confira a identificação do serviço e os campos de ambiente, quando definidos. Essa consulta verifica a identificação pública; o percurso de login e geração é conferido pela extensão.

Percorra o uso da integração

Confira os recursos comuns e, depois, o percurso específico da aplicação disponibilizada. Para o Zendesk, use Seu primeiro atendimento no Zendesk.

Verificação	Resultado a conferir
Conectar pelo Chrome	Endereço aceito e ambiente apresentado
Fazer login	Retorno ao painel com a conta correta
Abrir registro autorizado	Contexto e leitura disponíveis na aplicação integrada
Abrir Conexões	Fontes e vínculos esperados para a conta
Gerar um rascunho	Texto ou estado de resultado coerente com as fontes
Fazer uma pergunta	Resposta completa na conversa
Abrir uma ficha	Conteúdo conforme a ontologia do cliente, relacionado à aplicação de origem
Usar as ações da integração	Resultado no registro e no destino escolhidos, aguardando conclusão pelo usuário

Entregue à equipe

Forneça o canal de instalação, o endereço do Gateway, as instruções de rede/VPN, a conta a utilizar, a aplicação integrada e o domínio autorizado. Encaminhe os primeiros passos do Anywhere, o guia da integração disponibilizada e o contato do responsável pelo suporte do ambiente.

Aplicações

Acesso

Dados e ontologia

Modelar a ontologia

Governança

Operação

Disponibilize o Anywhere

Componentes necessários

Prepare a instalação da plataforma

Ative os serviços no Starter

Exemplo de endereços

Configure a autenticação

Confira as conexões entre serviços

Aplique e confira a implantação

Verifique a identificação pública

Percorra o uso da integração

Entregue à equipe

Próximos passos

Gerencie acessos e fontes

Instalação para o usuário

​Componentes necessários

​Prepare a instalação da plataforma

​Ative os serviços no Starter

​Exemplo de endereços

​Configure a autenticação

​Confira as conexões entre serviços

​Aplique e confira a implantação

​Verifique a identificação pública

​Percorra o uso da integração

​Entregue à equipe

​Próximos passos

Gerencie acessos e fontes

Instalação para o usuário

Componentes necessários

Prepare a instalação da plataforma

Ative os serviços no Starter

Exemplo de endereços

Configure a autenticação

Confira as conexões entre serviços

Aplique e confira a implantação

Verifique a identificação pública

Percorra o uso da integração

Entregue à equipe

Próximos passos