Steer tool choice

See what the agent calls

This digest plan gathers the commits since the latest release, but its description doesn’t say so:

.graph/plans/digest.yaml

version: 2
identifier: digest
name: Digest
description: Team digest.
steps:
- id: release
  tool_name: github__tool__gh_release
  input: {}
- id: commits
  tool_name: github__tool__git_log
  input:
    base: '{{release.tag}}'
    head: HEAD
finish:
  output:
    since: '{{release.tag}}'
    commits: '{{commits.commits}}'

Ask a question the plan answers:

graph ask "What have we merged since we last shipped?"

chat skips the plan and makes the same calls itself:

→ github__tool__gh_release {}
✓ github__tool__gh_release 1.1s
→ github__tool__git_log {"base":"v0.15.0","head":"HEAD"}
✓ github__tool__git_log 72.9ms

Describe the plan and add exemplars

Say what the plan returns in description, and list questions it answers under exemplars. The agent reads both in the plan’s tool description:

.graph/plans/digest.yaml

description: Team digest. The commits merged since the latest GitHub release.
exemplars:
- What have we merged since the last release?
- What's unreleased?

Ask again

graph ask "What have we merged since we last shipped?"

chat now calls the plan:

→ plan__digest {}
  → github__tool__gh_release {}
  ✓ github__tool__gh_release 995.2ms
  → github__tool__git_log {"base":"v0.15.0","head":"HEAD"}
  ✓ github__tool__git_log 50.5ms
✓ plan__digest 1.0s

Optimize an agent with plans

Move an agent’s repeated tool calls into a plan.

Customize a built-in agent

Change the chat agent itself.

Talk to an agent

Run agents with graph ask and graph chat.

Draft a plan in the workbench

Let the workbench write the plan and its description.

Getting started

Agents

Plans

Tools

Packs

Integrating

Reference

Steer tool choice

See what the agent calls

Describe the plan and add exemplars

Ask again

Optimize an agent with plans

Customize a built-in agent

Talk to an agent

Draft a plan in the workbench

​See what the agent calls

​Describe the plan and add exemplars

​Ask again

​Related guides

Optimize an agent with plans

Customize a built-in agent

Talk to an agent

Draft a plan in the workbench

See what the agent calls

Describe the plan and add exemplars

Ask again

Related guides