Adicionando instruções
Os agentes de IA operam com base em um conjunto de instruções comportamentais que definem como eles respondem às entradas do usuário, executam tarefas e interagem em diferentes canais. Essas instruções servem como diretrizes internas do agente, ajudando-o a agir de forma consistente e eficaz em vários cenários.
Ao configurar essas instruções, você pode garantir que o agente se alinhe ao tom da sua organização, aos objetivos comerciais e às expectativas do usuário. Independentemente de o agente estar respondendo a uma pergunta, acionando uma ferramenta ou colaborando com outro agente, essas regras ajudam a manter uma experiência perfeita e profissional.
As instruções são adicionadas na seção Behavior (Comportamento) do site Agent Builder. Depois de adicionados, eles são aplicados globalmente em todos os canais e tarefas, o que significa que o agente os segue independentemente de onde ou como é chamado.
Se suas instruções começarem a incluir muitas condições, ramificações ou sequências, considere usar um fluxo agênico. Os fluxos de trabalho o ajudam a codificar a lógica complexa em um formato estruturado e repetível que é mais fácil de gerenciar e dimensionar. Para obter informações detalhadas, consulte Criação de fluxos.
O que são instruções
As instruções são regras configuráveis que moldam o comportamento do agente. Eles determinam como o agente responde, quando aciona as ferramentas e como colabora com outros agentes. As instruções são adicionadas na seção Behavior (Comportamento ) do site Agent Builder e se aplicam globalmente a todos os canais e tarefas.
Instruções de quando usar
Use as instruções quando quiser:
Alinhe o tom do agente com sua marca.
Controle como o agente lida com cenários específicos.
Garantir um comportamento consistente em todos os canais e tarefas.
Permitir a colaboração com ferramentas ou outros agentes.
Antes de iniciar
Antes de adicionar instruções ao agente, é importante entender como elas funcionam e qual o impacto que têm:
As instruções substituem as existentes: Quando você insere novas instruções, elas substituem todas as regras definidas anteriormente. Não há suporte para controle de versão ou reversão, portanto, revise as alterações cuidadosamente antes de salvá-las.
As alterações são salvas automaticamente: Quando você insere ou modifica instruções, elas são aplicadas instantaneamente.
Os padrões se aplicam quando as instruções estão ausentes: Se você deixar o campo de instruções em branco, o agente se baseará em sua lógica integrada. Embora possa funcionar para casos de uso geral, talvez não esteja alinhado com suas necessidades comerciais específicas.
As instruções são aplicadas globalmente: Qualquer instrução que você adicionar será aplicada em todos os canais (por exemplo, chat, Slack) e em todas as tarefas que o agente realizar. Atualmente, não é possível definir instruções condicionais com base no contexto do usuário, no canal ou no tipo de tarefa.
Etapas para adicionar instruções
Para definir ou atualizar o comportamento de seu agente:
No menu principal, vá para Build.
Clique em Criar agente > Criar do zero.
Digite um nome e uma descrição.
Vá para a seção Comportamento.
No campo Instruções, insira regras claras e acionáveis.
Leia primeiro as recomendações para redigir instruções eficazes. Isso é essencial para ajudar a garantir que seu agente se comporte conforme o esperado.
As mudanças são salvas automaticamente.
Quando as instruções são adicionadas, o agente começa a usá-las imediatamente em todas as conversas. Essas regras influenciam a forma como o agente responde à solicitação do usuário, em todas as tarefas e canais conectados.
Personalização das respostas do agente com variáveis de contexto
Os agentes de IA podem adaptar as respostas com base no usuário com o qual estão interagindo e nas informações já disponíveis. As variáveis de contexto permitem respostas dinâmicas e personalizadas que refletem a situação atual e o perfil do usuário.
As variáveis de contexto funcionam como espaços reservados para dados específicos do usuário, como ID de e-mail, localização ou ID de associação, que podem ser inseridos no comportamento do agente. Com eles, seu agente se torna mais inteligente, responsivo e relevante.
Benefícios do uso de variáveis de contexto
Respostas personalizadas: Cumprimente os usuários pelo nome, consulte a localização deles ou adapte as respostas com base na função ou nas preferências deles.
Continuidade da sessão: Transportar informações por várias etapas ou tarefas sem pedir que o usuário se repita.
Integrações mais inteligentes: Compartilhe dados do usuário com ferramentas ou outros agentes para executar ações como buscar registros ou acionar fluxos de trabalho.
Como configurá-lo
Para usar variáveis de contexto, você deve primeiro defini-las usando o Agent Development Kit (ADK). O ADK fornece uma maneira de especificar o tipo de dados que seu agente reconhece e como acessá-los. Para obter mais informações, consulte “Fornecendo acesso a variáveis de contexto ”.
Como usá-los nas instruções
Depois que as variáveis forem definidas no ADK, você poderá fazer referência a elas diretamente na seção Behavior do site Agent Builder usando chaves {}.
Veja a seguir exemplos de instruções que usam variáveis de contexto:
- Always respond with watsonx Orchestrate email ID as {wxo_emailid}, wxo user name as {wxo_userid}, wxo tenant ID as {wxo_tenantid}, location as {location}, and member ID as {memberid}.
- Make a tool call when user input matches the tool description and respond to the user.
- Make a call to a collaborator agent when the user input matches its description. Pass {wxo_emailid}, {wxo_userid}, {wxo_tenantid}, {location}, and {memberid} to the collaborator agent so it returns the values back to you.
Recomendações para escrever instruções eficazes
Quando você escreve instruções para seu agente de IA, é importante seguir diretrizes claras e eficazes que garantam que o agente se comporte de forma consistente, profissional e alinhada com suas metas de negócios. Instruções bem definidas definem como o agente responde aos usuários, lida com as tarefas e mantém um tom profissional em todas as interações.
A seguir, há recomendações categorizadas para escrever instruções eficazes e evitar erros comuns.
O que fazer
Categoria |
Instruções recomendadas |
|---|---|
Seja específico |
"Encaminhe os problemas não resolvidos para um agente humano." "Use um tom educado em todas as respostas." "Peça esclarecimentos se a solicitação for vaga." |
Foco no comportamento |
"Não faça suposições se a intenção do usuário não estiver clara." "Resuma respostas longas sempre que possível." |
Definir limites |
"Não forneça aconselhamento jurídico, financeiro ou médico." |
Essas instruções ajudam o agente a se manter no caminho certo, manter um tom profissional e evitar ultrapassar sua função.
O que evitar
Categoria |
Instruções recomendadas |
|---|---|
Não seja vago |
"Dê sempre o seu melhor" "Seja prestativo" "Seja simpático" (a menos que faça parte de uma tarefa, como uma saudação) |
Não use lógica sem suporte |
"Responda assim apenas se o usuário parecer confuso" "Adapte o tom de voz de acordo com a emoção do usuário" |
Não inclua regras conflitantes |
"Mantenha as respostas curtas" + "Sempre forneça respostas detalhadas" |
Evite instruções vagas ou contraditórias, pois elas podem confundir o agente e levar a um comportamento inconsistente.
Exemplo de instruções eficazes para agentes
Use o exemplo a seguir como referência ao definir seu próprio comportamento de agente. O exemplo ilustra como escrever instruções claras, orientadas a objetivos e alinhadas à marca que ajudam seu agente a responder com precisão.
Exemplo: Agente de suporte de TI
Os exemplos de instruções a seguir definem o comportamento de um agente de suporte técnico que ajuda os usuários a solucionar problemas do sistema ou do ambiente, gerenciar tíquetes e fornecer orientações de configuração.
- Always greet the user courteously. Include their name if available. Example: Hello {wxo_userid}, how can I assist you with your system issue today?
- Maintain a clear, professional, and solution-oriented tone in all responses.
- When a user describes an issue, summarize their request before taking action to confirm understanding. Example: You’re facing a login failure on the staging environment, correct?
- If the issue matches a known error pattern, retrieve and summarize the related troubleshooting article from the knowledge base.
- When a tool or workflow is available for remediation (for example, Restart Server or Create Ticket), trigger it automatically and confirm the outcome to the user.
- Include relevant details such as environment name, ticket number, and affected component using context variables.
- If the issue cannot be resolved automatically, escalate it to the DevOps team with all collected diagnostic details.
- Never make changes to production systems without explicit user confirmation. Example: Do you want me to apply the configuration fix to the production environment?
- Close the conversation by confirming resolution or next steps. Example: Your ticket {ticket_id} has been created. The DevOps team will review it shortly.
O quê fazer em seguida
Quando terminar de adicionar instruções, execute as etapas a seguir para validar e refinar o comportamento do seu agente:
Teste seu agente na página de bate-papo para observar como ele aplica as novas instruções.
Conecte seu agente a um canal compatível (por exemplo, Slack, Microsoft Teams ) para avaliar as respostas em cenários reais. Para obter mais informações, consulte Conexão com canais.
Implante seu agente. Para obter mais informações, consulte Implantação de agentes.
Revise e atualize as instruções regularmente para refletir as mudanças nas suas metas comerciais, nas expectativas dos usuários ou nas tarefas suportadas.