Pular para o conteúdo principal

Recursos MCP

Os Recursos MCP permitem que agentes leiam dados estruturados do Alana sem fazer chamadas de ferramentas explícitas. Pense neles como anexos de dados somente leitura que o agente pode referenciar.

Recursos Disponíveis

URI do RecursoDescrição
alana://catalog/{catalog_id}Catálogo completo como dados estruturados
alana://product/{product_id}Detalhes do produto individual
alana://brand/{brand_id}Diretrizes e contexto de marca
alana://workspace/statsEstatísticas do workspace

Lendo um Recurso

// Listar recursos disponíveis
const resources = await client.listResources();

// Ler um recurso específico
const resource = await client.readResource({
  uri: "alana://catalog/cat_abc",
});
console.log(resource.contents[0].text);

Como Agentes Usam Recursos

Quando um agente precisa de contexto do catálogo, pode ler o recurso no início de uma sessão em vez de fazer chamadas repetidas a search_products. Isso reduz latência e chamadas de ferramentas para fluxos com muito contexto.

Prompts MCP

Os Prompts MCP são templates de fluxo de trabalho pré-construídos que agentes podem invocar. Eles combinam múltiplas chamadas de ferramentas em um único fluxo guiado.

Prompts Disponíveis

Nome do PromptDescrição
optimize-catalogExecutar otimização em um catálogo inteiro
analyze-productAnálise profunda de um produto
generate-feed-reportAnálise de performance de feed
brand-consistency-checkVerificar produtos contra diretrizes de marca

Usando um Prompt

// Listar prompts disponíveis
const prompts = await client.listPrompts();

// Obter um prompt com argumentos
const prompt = await client.getPrompt({
  name: "optimize-catalog",
  arguments: { catalog_id: "cat_abc", target_platform: "google" },
});

console.log(prompt.messages);

Prompt: analyze-product

Gera uma análise estruturada do produto incluindo score, sugestões de melhoria e recomendações por plataforma. Argumentos:
ArgumentoObrigatórioDescrição
product_idSimProduto para analisar
platformsNãoLista separada por vírgulas: google,meta,openai

Prompt: brand-consistency-check

Verifica um conjunto de produtos contra as diretrizes de marca e sinaliza inconsistências. Argumentos:
ArgumentoObrigatórioDescrição
brand_idSimMarca para verificar
catalog_idNãoCatálogo para auditar (padrão: todos)
Last modified on March 18, 2026