Ferramentas de contexto de sessão no Adobe CX Co-worker Gateway mcp-core

O Adobe CX Co-worker Gateway inclui um conjunto de ferramentas de contexto de sessão que estabelecem a organização da Adobe, a sandbox da Adobe Experience Platform e a visualização de dados da Customer Journey Analytics em que todas as outras ferramentas de produtos operam. Não é necessária nenhuma licença ou habilitação adicional — essas ferramentas estão disponíveis para todos os usuários autenticados após a conexão com o CX Co-worker Gateway server.

Como o contexto funciona mcp-core-how

O gateway do CX Co-worker inclui cada chamada de ferramenta em uma organização ativa da Adobe. Além disso, os requisitos de contexto dependem do produto:

  • Produtos baseados em Experience PlatformReal-Time CDP, Experience Platform e Journey Optimizer ferramentas operam em uma sandbox Experience Platform. Definir a sandbox uma vez por sessão com core-set_sandbox; todos os três a compartilham.
  • Outros produtos — Os produtos não criados no Experience Platform não usam o contexto de sandbox. Por exemplo, as ferramentas do Customer Journey Analytics são resolvidas em relação a uma exibição de dados e as ferramentas do Adobe Analytics são resolvidas em relação aos conjuntos de relatórios.

Definir o contexto uma vez no início de uma sessão — as ferramentas de produtos individuais não alternam entre organizações, sandboxes ou exibições de dados no meio da sessão.

Ferramentas disponíveis mcp-core-tools

Ferramenta
Descrição
core-list_orgs
Lista as organizações da Adobe acessíveis ao usuário autenticado. Retorna o nome para exibição e o identificador @AdobeOrg de cada organização. Use-a para pesquisar a ID da organização antes de chamar core-switch_org.
core-switch_org
Define a organização ativa da Adobe para a sessão. Todas as chamadas de ferramenta subsequentes têm escopo para essa organização até que a sessão termine ou a organização seja trocada novamente.
core-list_sandboxes
Lista as sandboxes da Experience Platform disponíveis na organização ativa. Retorna o nome, o título, o tipo (produção ou desenvolvimento) e o estado de cada sandbox. Use isso para procurar um nome de sandbox antes de chamar core-set_sandbox.
core-set_sandbox
Define a sandbox ativa do Experience Platform para a sessão. As ferramentas do Real-Time CDP, Experience Platform e Journey Optimizer colocam os dados no escopo dessa sandbox.
core-list_dataviews
Lista as visualizações de dados do Customer Journey Analytics disponíveis para o usuário autenticado no contexto atual. Retorna IDs de visualizações de dados e nomes de exibição. Use esta opção para procurar uma visualização de dados antes de chamar core-set_dataview.
core-set_dataview
Define a visualização de dados padrão do Customer Journey Analytics para a sessão. Quando definidas, as ferramentas do CJA que exigem uma visualização de dados — como findDimensions, findMetrics e runReport — usam esse valor automaticamente, a menos que uma visualização de dados diferente seja especificada na chamada de ferramenta individual.

Configuração típica de sessão mcp-core-setup

Defina o contexto no início de uma sessão antes de chamar as ferramentas do produto:

  1. Organização — Ligue para core-list_orgs para listar suas organizações acessíveis e, em seguida, para core-switch_org com a ID da organização de destino.
  2. Sandbox — Se você planeja usar as ferramentas do Real-Time CDP, Experience Platform ou Journey Optimizer, chame core-list_sandboxes para listar as sandboxes disponíveis e core-set_sandbox com o nome da sandbox de destino.
  3. Visualização de dados (somente CJA) — Se você planeja usar as ferramentas Customer Journey Analytics, chame core-list_dataviews para listar as visualizações de dados disponíveis e core-set_dataview com a visualização de dados escolhida.

Você pode solicitar ao cliente MCP que conclua essa configuração em uma única solicitação em idioma natural:

“Use a organização 1234ABCD@AdobeOrg, a sandbox prod e a visualização de dados My Company — Global para esta sessão.”

O cliente chamará as ferramentas apropriadas e confirmará quando o contexto for definido.

TIP
Se suas credenciais do Adobe pertencerem a apenas uma organização, core-list_orgs e core-switch_org ainda funcionarão, mas a organização efetiva será a mesma independentemente. Você ainda precisa chamar core-set_sandbox se planeja usar as ferramentas do Real-Time CDP, Experience Platform ou Journey Optimizer e core-set_dataview se planeja usar as ferramentas do Customer Journey Analytics.

Exemplo de prompts mcp-core-examples

Meta
Exemplo de prompt
Descobrir organizações disponíveis
“A quais organizações da Adobe eu tenho acesso?”
Definir contexto da organização
“Alternar para a organização My Org (1234ABCD@AdobeOrg).”
Descobrir sandboxes disponíveis
“Listar as sandboxes disponíveis em minha organização atual.”
Definir contexto da sandbox
“Use a sandbox prod para esta sessão.”
Descubra as visualizações de dados disponíveis
“Quais visualizações de dados do Customer Journey Analytics posso acessar?”
Definir contexto de visualização de dados
“Defina My Company — Global como a visualização de dados padrão.”
Configuração completa da sessão
“Configure uma sessão usando a organização 1234ABCD@AdobeOrg, a sandbox prod e a visualização de dados My Company — Global.”
recommendation-more-help
cx-enterprise-ai-help