Share via

Use prompts to make your agent perform specific tasks

  • Article

A prompt node integrates the custom prompt authoring feature of AI Builder to give instructions to the GPT model for your custom agent.

Add a prompt node in a topic

  1. Open a topic and select the Add node icon below the node under which you want to add the new node.

  2. Select Call an action > Create a prompt.

    Screenshot of the Add node menu with Call an action selected, and Create a prompt highlighted.

  3. Provide the agent with context, instructions, or other information relevant to your use case.

    Screenshot of the AI Builder Create a custom prompt window.

Note

If Manual Authentication is used, additional scopes need to be configured.

Follow the instructions provided at Configure user authentication with Microsoft Entra ID

Scopes should include: https://[OrgURL]/user_impersonation

Best practices for prompt instructions

When using the prompt node, it's important to follow best practices for prompt engineering. Here are some tips to help you get the most out of this feature:

  • Be specific: Custom instructions should be clear and specific, so the agent knows exactly what to do. Avoid vague or ambiguous language that could lead to confusion or incorrect responses.
  • Use examples: Provide examples to illustrate your instructions and help the agent understand your expectations. Examples help the agent generate accurate and relevant responses.
  • Keep it simple: Avoid overloading your custom instructions with too many details or complex logic. Keep your instructions simple and straightforward so the agent can process them effectively.
  • Give the agent a way out: Give the agent an alternative path for when it's unable to complete the assigned task. For example, when the user asks a question, you might include "respond with 'not found' if the answer isn't present." This alternative path helps the agent avoid generating false responses.
  • Test and refine: It's important to test your custom instructions thoroughly to ensure they're working as intended. Make adjustments as needed to improve the accuracy and effectiveness of your agent's responses.

Important

  • Prompts run on a GPT-3.5 Turbo model powered by Azure OpenAI Service.
  • This capability is limited to specific regions.
  • This capability might be subject to usage limits or capacity throttling.