Use Orchestrate copilot Prompt-Tune to When you run this command, make sure to activate an environment. Orchestrate copilot uses the active environment to fetch tools and data, helping you build more useful and relevant instruction
[BASH]
Copy
Ask AI
orchestrate copilot prompt-tune
Show command flags
Flag
Type
Required
Description
--file (-f)
string
yes
The path to an existing agent specification. This specification starts the prompt refinement flow. Without this flag, the agent creation flow starts instead. For more information, see Creating agent with Orchestrate copilot.
--output-file (-o)
string
Yes
The path to a YAML or JSON file where Orchestrate copilot saves the new agent specification. If not set, Orchestrate copilot uses the same path as the file used to start the prompt refinement flow, which overwrites the original agent specification. Do not set this flag if you use the --dry-run flag.
--dry-run
string
No
A flag that prevents saving the results to a file. Orchestrate copilot prints the new agent specification to the console instead.
--samples (-s)
string
No
The path to a CSV or TXT file with sample utterances the agent should handle. If not set, Orchestrate copilot prompts you to enter three examples in the interactive CLI session.
Note:
If you use the --help flag with this command, you see that it also includes the --llm flag. This flag applies only to the agent creation flow. If you set it to start the refinement flow, Orchestrate copilot ignores it. For more information, see Creating agent with Orchestrate copilot.
Command examples
Basic agent refinement
[BASH]
Copy
Ask AI
orchestrate copilot prompt-tune -f input.yaml
Orchestrate copilot interation exampleThe following example shows how you interact with Orchestrate copilot to refine an agent. In this case, you already created and imported the string_reverser tool into your local instance.
[BASH]
Copy
Ask AI
[INFO] - Please provide 3 sample utterances you expect your agent to handle: >: reverse "xyz" >: flip "abc" >: invert "123"[INFO] - You provided the following samples: 1. reverse "xyz" 2. flip "abc" 3. invert "123"🤖 Copilot: Based on your task description, I'll create an initial prompt. **Role** - You are an agent that can reverse strings according to the given command.**Tool Usage Guidelines** - 1. Before you call a tool, make sure you have all the required tool parameters.2. Do NOT assume any tool parameters3. Do NOT pass parameters to the tool that are not explicitly defined4. Do NOT call the same tool multiple times with the same parameters**How To Use Tools**- When the user wants to reverse a string, call the string_reverser tool with the string as a parameter.How would you like the output to be formatted? Should it be a simple reversed string, or would you like any additional information included?👤 You: I want the result formatted as a github markdown table with 2 coulmns. The left column should be the input and the right should be the output. Please include headers on the table🤖 Copilot: Based on your requirements, I'll refine the prompt.**Role** - You are an agent that can reverse strings according to the given command.**Tool Usage Guidelines** - 1. Before you call a tool, make sure you have all the required tool parameters.2. Do NOT assume any tool parameters3. Do NOT pass parameters to the tool that are not explicitly defined4. Do NOT call the same tool multiple times with the same parameters**How To Use Tools**- When the user wants to reverse a string, call the string_reverser tool with the string as a parameter.- Format the output of the string_reverser tool as a GitHub markdown table with two columns, "Input" and "Output", where the input string is in the "Input" column and the reversed string isin the "Output" column.Here's an example of what the output table might look like:| Input | Output || --- | --- || xyz | zyx |Are you interested in continuing to refine the prompt, or is this sufficient for your needs?👤 You: That is sufficient